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General  Information 


This  document  defines  the  language  Interface  to  Version  2.1  of  a  device-independent 
graphics  system  Intended  to  facilitate  the  use  of  graphics  In  the  command  and  control 
environment.  The  system  homogeneously  supports  graphics  terminals  of  widely  varying 
capability,  configured  with  one  or  more  different  programs  running  on  separate  computers 
connected  via  a  C2  communications  network.  These  include  both  calligraphic  and 
bit-map  displays  as  well  as  plotters.  The  sat  of  graphics  primitives  defined  here 
provides  a  core  upon  which  device-independent  application-tailored  graphics  packages 
can  be  built.  Advanced  graphics  features  such  as  color,  shading,  and  Input  from  multiple 
devices  are  supported  In  a  manner  that  permits  use  of  the  same  application  program  with 
devices  not  supporting  those  features.  The  graphics  system  performs  the  appropriate 
feature  mapping  to  support  the  connected  display  device.  For  example,  an  application 
program  may  specify  the  color  of  a  line  segment.  The  system  maps  the  specified  color 
Into  some  suitable  color  supported  by  the  device  or— In  the  case  of  a  monochromatic 
display— Into  the  single  color  of  that  device.  An  enquiry  capability  Is  also  provided, 
permitting  the  application  program  to  determine  the  characteristics  of  the  connected 
display  device  and  fully  exploit  all  of  Its  capabilities. 

The  graphics  system  provides  constructs  for 

-  Initiating  and  terminating  a  connection  with  the  desired  display  device. 

-  Allocating  a  graphics  output  area  of  a  specified  aspect  ratio  on  the  display 
device  viewing  surface. 

-  Defining  a  viewport  (subarea  within  the  allocated  area  of  the  display 
surface)  and  user  coordinate  system  to  be  mapped  to  that  viewport. 

-  Creating,  merging,  destroying,  displaying,  and  erasing  named  segments. 

-  Generating  graphics  entitles  such  as  lines,  dots,  text,  area,  and  shaded 
polygons  and  sectors. 

-  Controlling  display  characteristics  of  graphics  elements  (e.g.,  Intensity, 
color,  text  face  and  shading  parameters). 

-  Accepting  various  forma  of  Input  from  the  terminal. 

-  Retrieving  devtoe/syatem  status  Information. 

-  Sending  and  receiving  devlee-speelfle  orders. 

•  Storing  pictures  In  and  retrieving  ptotures  from  Graphic  Fiea. 
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This  document  Is  s  language  reference  menuel  for  Graphics  Lsnguege.  Appendix  A 
contelns  specifics  regsrdlng  e  pertlcular  Implementstion  of  this  language  for  FORTRAN*  10 
on  TENEX/T0PS-20. 

The  following  comments  sre  useful  for  understanding  Qrsphlcs  Language. 

1 .  The  run-time  environment  consists  of 


(IA)  An  application  program  (written  In  FORTRAN,  BUSS) 
or  some  other  programming  language  supported  by 
the  graphics  system, 

(IB)  The  graphics  system, 

(IC)  The  display  system. 

The  interface  between  (1A)  and  (IB)  Is  defined  within  this  document.  It 
should  be  thought  of  as  a  set  of  subroutine/procedure  calls,  rather  than  as 
a  programming  language. 

Information  exchange  between  components  of  (IB)  Is  defined  In  a  separate 
graphics  protocol  document  and  Is  of  concern  primarily  to  system  developers. 
It  may,  but  does  not  necessarily.  Include  transnet  communication,  depending 
upon  the  location  of  the  system  modules. 

The  Interface  between  (IB)  and  (1C)  depends  on  the  order  codes  of  the 
particular  device  on  which  the  graphics  Is  being  generated,  and  may,  but 
does  not  necessarily,  Inolude  transnet  communication. 

2.  The  language  separates  device-independent  from  device-dependent 
Issues.  Thus  Issues  like  [a]  the  size  and  position  of  the  TERMINAL 
display-viewport  on  the  CRT,  [b]  repainting  of  a  storage  tube,  and  [c] 
function  key  assignment  are  all  handled  Independently  of  application 
program  Interaction. 

3.  The  user  (l.e.,  the  programmer  using  Graphics  Language)  supplies  sufficient 
Information  to  the  graphics  system  to  allow  it  to  Identify  and  connect  to  the 
device,  and  also  requests  allocation  of  a  graphics  output  area  of  desired 
aspect-ratio  on  the  display  surface  via  the  INITIATE  command.  He  specifies 
either  explicitly  or  Implicitly  his  coordinate  system,  the  WINDOW,  and 
separately  a  sub-area  within  the  allocated  area  on  the  CRT  surface  to  be 
used,  the  VIEWPORT.  The  system  always  maps  the  entire  WINDOW  onto  the 
entire  VIEWPORT,  even  If  this  transformation  Is  not  a  conformal  mapping 
(l.e..  Introduces  "stretching").  For  details  of  these  specifications,  see 
WINDOW  and  VIEWPORT. 
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4.  The  smallest  nameable  display  entity  Is  a  segment.  Segments  have 
user-assigned  unique  (Os.  Segments  are  oreated  by  Issuing  an  OPEN  call 
followed  by  any  sequence  of  graphic  primitive  calls  (e.g.,  MOVE,  DRAW,  DOT, 
TEXT)  and  terminated  by  CLOSE.  Once  a  segment  has  baen  created,  It  can 
be  made  visible  by  Issuing  POST,  or  invisible  by  UNPOST.  A  segment  may  be 
POSTed  or  UNPOSTad  many  times.  Segments  may  be  MERGEd  Into  a  single 
segment.  When  the  segment  Is  no  longer  needed,  It  Is  KILLed  to  release 
memory  associated  with  its  graphic  primitives  and  to  free  the  ID. 

5.  The  Graphics  Language  deals  with  absotuts  transformed  display  segments 
only.  All  transformations  (e.g.,  those  resulting  from  the  VIEWPORT/WINDOW 
relation)  are  performed  when  the  segment  Is  defined.  No  transformation 
may  be  applied  to  segments  already  generated.  As  a  result,  the  effect  of 
motion  can  be  achieved  only  by  replacing  already  displayed  entitles  with 
newly  generated  ones. 

0.  The  system  maintains  a  status  array  that  Includes  Important  parameters 
that  are  available  to  the  user.  These  Include  error  reports,  scope  size, 
display  system  capabilities,  etc.  A  complete  list  of  these  Is  shown  later, 
under  the  description  of  the  ENQUIRE  command. 
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Graphics  Language  Calls 


This  section  contains  Information  on  the  various  Graphic  Language  (GL)  calls  available  to 
the  application  programmer.  The  calls  are  grouped  In  ten  sections  according  to  their  role 
In  creating  the  user's  graphic  output.  Each  call  Is  presented  In  terms  of  Its  Intended 
effect;  any  side  effects  that  may  result;  the  order,  type,  and  value  range  of  required 
parameters;  and  any  error  conditions  that  might  result  from  Improper  use  of  the  call. 


[I]  DEVICE  CONNECTION  INITIATION  AND  TERMINATION 


The  following  GL  calls  sre  used  to  Initiate  and  terminate  a  connection  with  a  display 
device.  Initiating  a  connection  results  In  the  binding  of  various  components  of  the 
graphics  system  with  the  application  program  and  the  requested  display  device.  It  also 
establishes  a  number  of  defaults  for  various  GL  commands  discussed  later  In  this 
document.  These  defaults  Include  the  user's  coordinate  system,  the  area  on  the  display 
surface  on  which  the  user's  graphic  output  will  appear,  and  the  diaplay  attributes  for 
graphic  primitives  such  as  text  and  vectors.  The  user  may  override  these  defaults  or 
establish  his  own  default  values  via  commands  discussed  In  subsequent  portions  of  this 
document. 


INITIATE  f  CONFIGURATION-STRING.  ASPECT-RATIO  ) 

Establish  a  connection  to  and  Initialize  the  display  device,  reset  all  buffers  and 
parameters  to  their  default  values,  and  retrieve  device  specific  Information  from  the 
display  device.  The  first  parameter  Is  a  character  string,  the  second  Is  a  real  number. 

CONFIGURATION-STRING  specifies  system  configuration  and  display-device  Information, 
l.e.,  the  type  and  location  of  graphic  system  modules,  the  display  device  type,  location, 
and  connection  protocol.  The  format  of  this  Information  depends  on  the  environment  In 
which  the  system  Is  Implemented.  See  Appendix  A  for  further  Information. 

ASPECT-RATIO  specifies  the  desired  aspect  ratio  for  the  area  on  the  display  aurface  to 
be  allocated  for  this  connection.  Values  less  than  0.  Indicate  that  the  default  aspect 
ratio  for  the  viewing  surface  should  be  used;  values  greater  than  0.  Indicate  the  ratio  of 
the  width  to  the  height  of  the  desired  area.  Thus,  the  value  .5  requests  a  working  area 
In  which  the  vertical  size  Is  twice  the  horizontal  size,  and  a  value  of  2.0  requests  a 
working  area  In  which  the  horizontal  size  Is  twice  the  vertical  size.  An  area  of  the 
desired  aspect  ratio,  the  allocation-viewport,  wW  be  assigned  to  the  application  from  the 
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available  working  araa  on  the  davlca  surface.  It  will  ba  given  an  addreaa  range  of 
(0.,0.,W,H)  for  purposes  of  subsequent  VIEWPORT  calls  where  the  smaller  of  the  pair 
(W,H)  la  1.0  and  the  larger  Is  proportlonslly  grester  according  to  the  aapect-retlo 
requested.  The  values  of  W  snd  H  are  made  svaltsble  to  the  user  via  worda  1 4  and  1 6 
of  the  enquiry  array  (sea  ENQUIRE).  Tha  physloal  slza  and  actual  location  of  the 
aHocatlon*vlewport  la  Implementation  and  connection  dependent.  Ita  size  In  oentlmetere 
la  made  available  to  the  application  via  words  12  and  13  of  the  enquiry  array. 

Aa  a  reault  of  this  call,  various  device  and  connection  specific  Information,  Including  the 
Information  opacified  above,  Is  made  available  to  the  application  program  via  the  enquiry 
array. 

Poaalble  errors: 

ERR-00  Davlca  not  known  to  the  ayatem  or 
not  available. 


RELEASE 

Release  the  display  device  and  system  modules  being  used.  Terminate  any  network 
connections. 


Poaalble  errors: 


e 


GRAPHICS  LANGUAGE  (VERSION  S.l) 


t?l  VIEWINC  AREA  AND  COORDINATE  SYSTEM  SELECTION 


The  following  commands  specify  the  subarea  (viewport)  of  the  allocation- viewport  In 
which  the  user's  graphic  output  will  appear  and  the  X,Y  bounds  of  the  user's  coordinate 
system  (window)  to  be  mapped  to  that  viewport.  Graphic  primitives  that  extend  outside 
of  the  specified  X,Y  range  of  the  window  will  be  clipped  at  the  specified  boundaries; 
portions  outside  of  the  window/viewport  boundary  will  not  appear  on  the  display  surface. 
The  viewport/window  pair  allows  the  application  programmer  to  both  scale  and  translate 
his  pictures  to  any  area  of  the  display  surface  allocated  to  his  program.  Depending  upon 
the  values  of  the  window  and  the  viewport,  the  user's  picture  may  be  distorted 
(stretched)  In  either  the  X  or  the  Y  direction.  Choice  of  appropriate  window  values  allows 
the  application  to  selectively  view  and/or  enlarge  particular  portions  of  a  specified 
picture. 


VIEWPORT  (  XL.  YB.  XH.  VT  ) 

Select  a  subarea  of  the  allocation-viewport  In  which  subsequent  graphics  will  appear.  All 
the  arguments  are  real  numbers  and  must  range  from  0.  to  the  maximum  for  the 
allocation-viewport  assigned  during  the  INITIATE  oall  as  Identified  via  words  14  and  15  of 
the  enquiry  array. 

The  largest  left-  and  down-justified  square  of  the  allocation-viewport  Is  defined  by  the 
value  range  (0.,0.,1.,1.).  In  this  coordinate  system  the  top  half  of  this  squsre  Is  defined 
by  (0...5.1..1.). 

This  call  does  not  affect  any  segment  (or  part  thereof)  already  generated.  The  current 
beam  position  of  an  OPEN  segment  remains  at  the  same  location  In  the 
allocation-viewport  after  a  VIEWPORT  call  as  It  was  prior  to  that  call.  The  values  for  the 
current  beam  position  within  the  old  coordinates  are  adjusted  to  correspond  to  the 
values  for  the  new  VIEWPORT  call. 

The  system  Initialization  default  la  VIEWPORT(0.,0.,1.,1.).  Thus,  If  no  VIEWPORT  call  Is 
Issued  by  the  application  program,  the  largest  left-  and  down-justified  square  from  the 
allocation-viewport  Is  used. 

It  Is  not  legal  to  have  XL«XR,  YB»YT,  XL>XR,  or  YB>YT. 

Possible  errors: 

ERR -07  The  specified  values  are  out  of  the 
allowable  range  as  defined  by  the 
allocation-viewport  or  XL*XR,  YB*YT, 

XL>XR  or  YB>YT. 
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WINDOW  (XL.VB.  XB.  YT  ) 

Define  ths  user  coordinate  system  for  the  current  VIEWPORT.  Values  are  specified  ea 
real  numbers.  The  identified  coordinate  range  Is  mapped  onto  the  viewport.  Uaer 
graphics  outside  the  specified  coordinate  range  will  be  clipped  at  the  window  boundaries 
to  Include  only  that  portion  within  the  WINDOW  coordinates. 

The  call  does  not  effect  sny  segment  (or  part  thereof)  already  generated.  The  current 
beam  position  of  an  OPEN  segment  In  the  old  coordinate  range  Is  adjusted  to  correspond 
to  the  coordinates  of  the  new  WINDOW  call.  The  call  may  be  reissued  whenever  needed, 
even  within  a  segment. 

The  system  Initialization  default  Is  WINDOW(0.,0.,1.,1.).  Thus,  If  no  WINDOW  oell  la  laaued 
by  the  application  program,  any  vectors,  text,  etc.,  with  start  and  end  points  within  thla 
value  range  will  appear  on  the  screen  while  those  with  start  or  end  points  outelde  of  thla 
range  will  be  clipped  at  the  window  edges. 

It  Is  legal  to  have  XL>XR  or  YB>YT,  In  order  to  achieve  mirroring.  However,  XL»XR  or 
YB«YT  Is  not  legal  and  results  In  an  error. 

Possible  errors: 

ERR*0  7  XL«XR  or  VB*YT. 
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[S]  SECMENT  SPECIFICATION 


The  following  GL  calls  allow  the  application  programmer  to  name  and  define  the  contents 
of  an  Individual  GL  ugmtnt.  A  segment  Is  a  named  collection  of  GL  primitives  (lines,  dots, 
text,  arcs,  polygons,  sectors,  etc.).  Once  created,  segments  can  be  merged  with  other 
segments,  renamed,  made  visible  or  Invisible,  highlighted,  made  touch  sensitive,  and 
destroyed.  These  operations  are  discussed  In  section  4  of  this  document. 


Segment  Identification 

A  given  set  of  graphic  primitives  Is  associated  with  a  segment  by  virtue  of  the  following 
two  calls  that  both  delimit  the  bounds  of  the  segment  and  assign  a  name  by  which  the 
appllcetlon  program  can  subsequently  refer  to  that  segment. 


OPEN ( N ) 

Initiate  specification  of  a  segment  with  10  N.  AU  subsequently  specified  graphic  primitives 
(lines,  text,  dots,  etc.)  are  to  be  associated  with  the  segment  named  N  until  a  CLOSE  Is 
Issued,  l.e.,  segment  N  consists  of  all  graphics  primitives  specified  between  the  OPEN 
and  CLOSE  calls.  The  ID,  N,  Is  an  Integer  between  1  and  32000.  If  any  other  segment  Is 
still  open  when  an  OPEN  Is  Issued,  then  a  CLOSE  (see  below)  Is  Implied  for  that  segment. 

Segments  are  always  Initialized  with  the  segment  default  conditions  In  effect  (color  and 
text  attributes)  when  this  call  Is  Issued.  These  default  conditions  are  set  during  system 
Initialization  to  the  values  Indicated  In  the  discussion  of  the  particular  calls  (see  COLOR 
and  TEXTFACE  below).  They  may  be  changed  via  the  DEFAULT-COLOR  and  DEFAULT-TEXT 
calls  discussed  In  section  8  of  this  document. 

When  this  GL  call  Is  Issued  the  current  beam  position  Is  undefined,  and  Its  value,  as 
available  through  an  ENQUIRE  call,  Is  not  necessarily  valid. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR- 18  No  scope  selected. 


0 


fikfilE 

Terminate  specification  of  the  currently  open  segment.  If  a  segment  with  the  same  ID,  N, 
already  exists,  It  Is  replaced  by  this  segment,  which  assumes  Its  display  attributes.  If 
the  old  segment  was  visible,  (l.e.,  POSTed),  Its  replacement  will  be  too.  If  the  old  one 
was  NIGHLIGHTed,  the  new  segment  will  also  be  highlighted.  Otherwise  the  segment  Is 
Initially  Invisible  and  nonhlghllghted.  If  there  la  no  open  segment,  no  action  Is  taken. 

Possible  errors: 

ERR-02  System  table  overflow. 


Display  Mode  Specification 

The  following  set  of  GL  calls  Indicates  the  preferred  msnner  for  subsequently  specified 
grephlc  primitives  to  appear  on  the  display  surface.  Whether  or  not  the  displayed  graphic 
primitives  actually  appear  according  to  the  specified  mode  settings  depends  upon  the 
capabilities  of  the  graphics  system  and  the  display  device. 


reigffi  i.  n.  q«  n 

Set  the  Intensity  and  chromatlclty  for  the  rest  of  this  segment.  I,  R,  G,  and  S  are  real 
numbers.  I  determines  the  Intensity. 


1*1.  Highest  available  Intensity  (same  for  I  >  1.) 

1*0.  Lowest  available  Intensity  (same  for  I  <  0.) 

For  any  0.  <  I  <  1 .  the  system  will  choose  an  appropriate  Intensity  level. 

The  R,  G,  B  values  determine  the  chromatlclty  (hue  and  saturation).  Since  chromatlclty  la 
uniquely  determined  by  only  two  of  the  R,  G,  B  values,  at  least  one  of  the  values  must  be 
zero.  If  the  user  specifies  all  three  values  greater  than  0,  the  system  maps  at  least  one 
to  zero  by  the  following  computation: 


COLOR  (I,  R-mln(R,G,B),  G-mln(R.G.B),  B-mln(R,G,B)) 

The  ENQUIRE  can  (see  Section  7)  may  be  used  to  find  the  available  Intensities  and 
colors.  The  Initialization  default  for  eaoh  segment  la  C0L0R(1.,0.,0.,0.). 
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Possible  •rrors: 

ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 


INTENSITY  (  I  ) 

Set  the  Intensity  level  for  the  remainder  of  this  segment.  I  Is  specified  as  a  real  number. 


1*1 .  Highest  available  Intensity  (same  for  I  >  1.) 

1*0.  Lowest  available  Intensity  (same  for  I  <  0.) 

For  any  0.  <  I  <  1.  the  system  will  choose  an  appropriate  Intensity  level.  This  call  Is 
equivalent  to  COLORO.,0.,0.,0.).  The  ENQUIRE  call  (see  Section  7)  mey  be  used  to 
determine  the  range  of  Intensities  available.  The  Initialization  default  for  each  segment  Is 
INTENSITYO.). 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 


TEXTFACE  (MASK.  NAME. 
HORIZONTAL-SPACING) 


QUALITY.  HEIGHT.  WIDTH,  VERTICAL-SPACING 


Select  a  text  face/font  based  upon  the  Indicated  attributes.  Use  the 
VERTICAL-SPACING  and  HORIZONTAL-SPACING  values  (If  specified)  to  perform 
Intercharacter  apaclng. 


The  MASK  parameter  Indicates  which  of  the  subsequent  variables  are  set  and,  hence, 
are  to  be  used  In  the  text  font  selection  process  or  Intercharacter  spacing.  If  a  variable 
Is  not  set,  then  the  default  for  that  field  Is  used.  Values  of  the  MASK  parameter  range 
from  0  to  03  as  follows: 


MASK  ■  0:  None  of  the  subsequent  parameters  are  to  be  Included  In  the  text 
font  selection  process;  use  the  device  default  text  face/font.  The 
default  Intercharacter  spacing  values  for  the  selected  font  are  to 
be  used  for  positioning  characters. 

■  1:  The  text  NAME  parameter  Is  set  and  may  be  Included  In  the  font 
selection  process. 


*  2<  The  text  QUALITY  parameter  Is  set  and  may  be  Included  In  the  font 
eelectlon  process. 
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•  4:  Ths  HEIGHT  parameter  Is  sat  and  may  ba  Includad  In  tha  font 
salactlon  procasa. 

■  8:  Tha  WIDTH  parameter  la  sat  and  may  be  Includad  In  tha  font 
salactlon  procasa. 

■16:  Tha  VERTICAL-SPACING  parameter  is  set;  Intarcharactar  vertical 

spacing  Is  to  ba  performed  according  to  tha  value  of  tha 
VEBTICAL-8PACING  parameter. 

■32:  Tha  HORIZONTAL -SPACING  parameter  Is  sat;  Intaroharactar 

horizontal  spacing  la  to  ba  performed  according  to  tha  value  of  tha 
HORIZONTAL-SPACING  parameter. 

Combinations  of  those  values  are  used  to  specify  that  more  than  one  of  tha  parameters 
aro  to  bo  Included  In  tha  font  selectlon/intercharacter  positioning  process.  Tha  manner 
In  which  specific  parameters  aro  employed  In  the  font  selection  process  Is  described 
below. 

The  NAME  parameter  indicates  the  name  of  the  desired  text  face  to  be  used,  e.g., 
BODONI,  NEWS  GOTHIC  READER,  TIMES  ROMAN  (see  Appendix  C).  If  the  value  is  not  used 
In  the  font  selection  process  (La.,  the  corresponding  bit  In  the  mask  variable  Is  set  to 
zero),  the  default  text  face  is  used.  The  QUALITY  parameter  indicates  the  type  of  text 
required  (0>hardware,  1  ^stroked).  Stroked  text  Is  automatically  scaled  to  the  specified 
HEIGHT  and  WIDTH  as  described  below.  Hardware  text  Is  matched  to  the  height  and 
width  in  that  order.  The  HEIGHT  parameter  is  used  to  Indicate  the  desired  text  height  In 
window  units  (real  number)  of  the  selected  text  font.  The  WIDTH  parameter  is  used  to 
Indicate  the  desired  text  width  in  window  units  (real  number).  In  the  case  of  hardware 
generated  text,  If  the  HEIGHT  parameter  is  set,  the  hardware-supported  text  font  (of 
the  specified  text  face)  whose  height  comes  closest  to  the  specified  height  without 
actually  exceeding  It  Is  selected.  In  this  case  the  WIDTH  parameter  Is  Ignored.  If  the 
HEIGHT  parameter  is  not  sot,  then  the  text  font  whose  width  comes  closest  to  the 
specified  width  without  exceeding  It  is  selected. 

Since  most  hardware  character  generators  cannot  generate  characters  of  arbitrary  size, 
It  Is  likely  that  for  hardware  text  the  actual  character  height  and  width  used  will  differ 
from  the  specified  height  and  width.  In  order  to  find  the  actual  character  height  and 
width  that  result  from  this  call,  an  ENQUIRE  call  (aee  Section  7)  must  be  Issued. 

The  actual  text  font  selected  for  a  given  TEXTFACE  command  depends  upon  both  the 
parameters  of  the  TEXTFACE  command  and  the  actual  hardware  and  stroked  fonts  that 
are  supported.  An  attempt  Is  first  made  to  find  a  matching  font  of  the  specified  quality 
and  tha  specified  face  name.  If  this  attempt  falls,  then  an  attempt  Is  made  to  find  a  font 
of  any  quality  of  the  specified  face.  If  this  attempt  also  falls,  then  an  attempt  Is  made  to 
find  a  font  of  the  specified  quality  but  of  any  faoe.  Finally  If  the  previous  attempts  hove 
failed,  a  search  la  mada  for  a  font  of  any  faoa  name  and  any  quality  that  satleflea  the 
text  alze  constraints. 
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If  the  VERTICAL-  and/or  HORIZONTAL-SPACING  parameters  are  set,  characters  are 
Individually  positioned  according  to  the  values  of  these  parameters.  The 
VERTICAL-SPACING  parameter  Indicates  the  value  In  window  units  (real  number)  by  which 
a  character  Is  to  be  displaced  In  the  vertical  direction  from  the  previous  character.  If 
this  value  Is  positive,  then  subsequent  characters  will  be  displaced  In  an  upward 
direction  from  the  preceding  character.  If  the  value  Is  negative,  then  subsequent 
characters  will  be  displaced  In  a  downward  direction  from  the  preceding  character.  The 
value  of  the  HORIZONTAL-SPACING  parameter  Indicates  the  amount  In  window  units  (real 
number)  by  which  a  character  Is  to  be  displaced  from  the  right-hand  edge  of  the 
previous  character.  If  the  value  Is  positive,  then  the  displacement  will  be  In  a  right-ward 
direction,  if  the  value  is  negative,  then  the  displacement  will  be  in  a  left-ward  direction. 
For  example,  if  the  VERTICAL-SPACING  value  is  the  negative  of  the  character  height  and 
the  HORIZONTAL-SPACING  value  is  the  negative  of  the  character  width,  then  a 
descending  vertical  string  of  characters  will  be  generated. 

The  initialization  values  for  text  size  and  spacing  are  the  device  default  values. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-03  No  opon  segment. 

ERR-1 1  No  font  small  enough. 


Vector  Specification  (Absolute  Coordinate  Form) 

The  following  commands  specify  graphic  primitives  In  terms  of  the  absolute  window 
coordinates  Involved. 


Display  a  dot  at  the  specified  position  (In  the  user's  coordinate  system).  X  and  Y  are 
given  as  real  numbers.  The  beam  position  Is  left  at  the  specified  point.  The  dot  Is 
displayed  only  If  It  Is  Inside  the  window.  It  is  displayed  according  to  the  current 
Intensity /color  setting. 


Possible  errors: 


ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 
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DRAW  C  X.  Y  ) 

Draw  •  line  from  the  current  beam  position  to  tha  specified  position.  X  and  Y  are  given 
as  real  numbers.  The  beam  position  is  left  at  the  specified  point.  The  line  is  clipped,  If 
needed.  It  Is  displayed  according  to  tha  currant  Intensity/color  setting.  If  the  current 
beam  position  is  undefined,  then  the  results  of  this  call  are  undefined. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 


Move  the  beam  position  to  the  specified  point,  without  any  drawing.  X  and  Y  are  given 
as  real  numbers. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 


UME1A  r.  I ) 

MOVE  or  DRAW.  If  l«0,  then  this  call  Is  equivalent  to  MOVE(X,Y);  if  1-1,  then  It  la 
equivalent  to  DRAW(X.Y).  As  In  MOVE(X,Y)  snd  DRAW(X.Y),  X  and  Y  are  specified  as  real, 
absolute  coordinates,  I  as  an  Integer  value.  The  drawing  of  the  Hne  Is  affected  by  the 
Intensity/color  setting.  The  line  Is  clipped,  If  necessary. 

Possible  errors; 

ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 


&asi  x..y,  ft.  ?a,  ea  ) 

Draw  a  circular  arc  with  radius  R  snd  center-point  (X,Y),  starting  at  angle  SA  and 
proceeding  in  a  counter-clockwise  direction  through  angle  EA.  AH  the  arguments  are 
given  as  real  numbers.  X,  Y,  and  R  are  specified  In  the  user's  (window)  coordinates;  SA 
end  EA  specify  the  starting  and  ending  angles  In  radians,  with  0  corresponding  to  "right" 
and  PI/2  to  "up".  The  number  of  straight  lines  used  to  approximate  the  arc  may  vary 
according  to  the  system  resolution  and  the  actual  R.  The  arc  Is  drawn  according  to  the 
current  Intensity/odor  setting  and  Is  clipped,  as  necessary. 
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Not«  that  if  tha  aspect-ratios  of  the  WINDOW  and  the  VIEWPORT  differ,  then  circular 
arcs  In  the  user's  coordinates  are  elliptic  arcs  In  the  VIEWPORT  coordinates,  and  this  cell 
la  not  necessarily  supported. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 

ERR-07  R<0  or  R*0. 

ERR- 10  The  arc  Is  not  circular  (but  elliptic). 


Vector  Specification  (Relative  Coordinate  Form) 

The  following  commands  specify  graphic  primitives  In  terms  of  the  desired  X  and  Y 
displacement  In  window  coordinates  from  the  current  beam  location.  They  are  most 
commonly  used  In  creating  subroutines  for  repeating  the  same  set  of  graphic  primitives 
Independent  of  the  current  beam  location.  In  such  cases  the  routine  would  be  called  to 
generate  the  graphic  object  after  the  main  program  had  positioned  the  beam  at  the 
desired  origin.  If  the  beam  position  for  the  currently  open  segment  Is  undefined,  the 
result  of  these  calls  is  undefined. 


BEIATIVE-DOT  (  PX.  DY  ) 

Display  a  dot  In  the  position  specified  relative  to  the  current  beam  position.  DX  and  DY 
are  given  as  real  numbers.  The  currant  beam  position  becomes  the  specified  point.  If 
the  beam  position  immediately  prior  to  this  call  being  Issued  Is  (X,Y),  then  after  this  call  It 
Is  (X+DX.Y+DY).  The  dot  Is  displayed  according  to  the  current  Intensity/ color  setting,  but 
only  If  It  Is  Inside  the  window. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 


RELATIVE-DRAW  (  DX.  DY  ) 

Draw  a  line  from  the  current  beam  position  to  the  point  (X+DX.Y+DY)  where  (X,Y)  Is  the 
beam  position  before  the  call.  DX  and  DY  are  given  as  real  numbers.  The  line  Is  displayed 
according  to  the  current  Intensity/color  setting,  and  Is  clipped,  as  necessary. 


Posalble  errors: 


ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 
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WB^TtVB-W9VE  t  PX.  Bli 

Move  the  beam  position  from  the  current  beam  position  (X,Y)  to  (X+DX.Y+DY)  without  any 
drawing.  OX  and  DY  are  given  as  real  numbers. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 


KIMM-UNE 1 BX.  ttUll 

RELATIVE-MOVE  or  RELATIVE-DRAW.  If  NO,  then  this  call  la  equivalent  to 
RELATIVE-MOVE(DX,DY)t  otherwise  It  Is  equivalent  to  RELATIVE-DRAW(DX.DY).  As  In 
RELATIVE-MOVE(DX,OY)  and  RELATIVE -DRAW(DX,DY),  DX  and  DY  are  supplied  as  reel 
values  In  relative  coordinates.  I  la  given  as  an  Integer  value.  It  la  displayed  according  to 
the  current  Intensity/color  setting  and  Is  clipped,  as  necessary. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 


WElAT|VE-ftn<?  ( fl,  8ft,  EAj 

Draw  a  circular  arc  relative  to  the  current  beam  position.  This  call  Is  Identical  to 
ARC(X,Y,R,SA,EA)  where  (X,Y)  Is  the  current  beam  position. 


Text  Specification 

The  following  routine  allows  the  user  to  specify  a  text  string  to  appear  on  the  display 
surface.  The  text  string  is  clipped  according  to  the  window  specification  and  the  location 
of  characters  with  regard  to  the  window.  The  size  of  the  characters  actually  generated 
depends  upon  the  results  of  the  TEXTFACE  command  Issued  by  the  user  or  the  default 
TEXTFACE  command  Issued  by  the  system. 


ie 
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IKIlUdnai 

Show  a  taxt  string  stsrting  at  tha  ourrant  baam  position.  The  current  beaRt  position 
becomes  the  lower  left  comer  of  the  first  chsracter.  The  beam  position  Is  left  at  the 
position  computed  by  adding  tha  vertical  and  horizontal  spacing  values  to  the  lower  right 
corner  of  the  last  charsctar  (equivalent  to  the  lower  left  of  the  next  character  position). 

Tha  text  Is  displayed  according  to  the  currant  Intensity/color  and  textface  settings. 
Text  clipping  eliminates  any  character  not  totally  within  tha  window.  If  the  current  beam 
position  Is  undefined,  then  the  results  of  this  call  are  undefined. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 


Area  Specification 

The  following  commands  allow  the  application  programmer  to  specify  areas  In  his 
coordinate  system  to  be  filled  according  to  specified  parameters.  The  visible  result  of 
the  area  fill  request  depends  on  the  graphics  system  and  the  display  device.  In 
particular  solid  filling  may  not  be  supported  on  particular  types  of  devices  and  may  be 
defaulted  to  single  or  double  hatohlng. 


FH.I-8ECTOR  (  X.  Y.  R.  8A.  EA.  MODE.  ANQLE.  PI8T  ) 

Fill  the  specified  sector.  X,  Y  and  R  are  specified  as  real  numbers  In  the  user's 
coordinate  system  and  correspond  to  the  center  and  radius  of  the  sector.  SA  and  EA 
represent  the  starting  angle  and  ending  angle  (In  radians)  for  the  sector  where  SA«0.0 
corresponds  to  a  ray  emanating  from  the  center  of  the  circle  and  oriented  to  the  right. 
The  sector  Is  constructed  by  proceeding  In  a  counter-clockwise  fashion  from  SA  until  the 
value  EA  Is  reached.  The  sector  described  by  X,  Y,  R,  SA  and  EA  Is  filled  according  to  the 
mode,  angle  and  dlstanca  values  as  follows: 


mode  ■  0  Implies  no  fill  pattern, 
mode  ■  1  implies  single  hatching, 
mode  ■  2  Implies  cross-hatching, 
mode  ■  3  Implies  solid  filling. 

Angle  Is  the  angle  In  radians  for  subsequent  hatching  marks  for  mode  *  1  and  mode  *  2. 
Olstance  is  the  perpendicular  distance  between  consecutive  hatching  marks  In  window 
units. 
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This  operstlon  is  performed  according  to  the  current  intensity  and  color  settings. 
Clipping  Is  applied  as  needed.  The  beam  position  for  the  currently  opened  segment 
remains  unchanged. 

Note  that  If  the  espect  ratio  of  the  WINDOW  and  the  VIEWPORT  differs,  then  this  call 
does  not  specify  a  circle  and  Is  not  necessarily  supported. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 

ERR-07  R<0  or  R*0. 

ERR- 18  The  specified  area  Is  not  circular 

(but  elliptic). 


rJlLfaiiteLN 

VCRTC&1*.JU 


Fill  the  following  N-vertex  polygon.  FILL-POLYGON  specifies  the  beginning  of  the 
definition  of  a  polygon.  The  polygon  is  defined  by  Its  N  vertices  (in  user  coordinates), 
specified  by  N  consecutive  VERTEX  calls  progressing  from  an  arbitrary  vertex  around  the 
polygon  In  either  a  clockwise  or  counter-clockwise  direction.  Polygon  specification  Is 
terminated  by  a  TERMINATE-POLYGON  call,  which  also  specifies  the  filling  parameters  In 
identical  fashion  to  the  FILL-SECTOR  call.  The  polygon  must  be  a  simple  closed  curve 
(l.e.,  does  not  Intersect  Itself).  The  Nth  vertex  Is  connected  to  the  first. 

This  operation  Is  performed  according  to  the  current  Intensity  and  color  settings. 
Clipping  of  the  polygon  is  performed  as  necessary.  The  beam  position  for  the  currently 
opened  segment  remains  unchanged. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-03  No  open  segment. 

ERR-07  N<3. 

ERR- 10  Bed  polygon  specification. 
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14]  SEGMENT  CONTROL 


The  following  set  of  Gl  calls  manipulate  segments  that  have  been  created  via  the 
SEGMENT  SPECIFICATION  calls.  Calls  are  provided  to  merge  two  existing  segments, 
rename  a  segment  to  a  new  name,  make  segments  visible  or  Invisible,  highlight  segments, 
make  the  visible  portions  of  segments  sensitive  to  touch  detection,  and  delete  segments 
from  the  system. 


MERGE  (  N.  M  ) 

Merge  segment  N  Into  segment  M.  Display  entitles  in  N  are  catenated  to  M  under  the 
display  attributes  of  M.  Segment  N  no  longer  exists  after  this  operation.  If  segment  M  Is 
not  defined,  this  call  renames  segment  N  to  M. 

Segment  N  and  M  must  have  Identical  scope  attributes.  Any  queued  Input  for  segment  N 
is  subsequently  associated  with  segment  M. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-04  Segment  N  does  not  exist,  N«0,  or  M«0. 

ERR- 16  Dissimilar  scopes. 


rein  NJ. 

Make  segment  N  visible.  If  segment  N  Is  already  visible,  l.e.,  POSTed,  no  further  action  la 
taken.  POST(O)  results  In  POSTIng  all  the  segments. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-04  Segment  N  does  not  exist 

(for  N>0). 


MHEgjlUU 

Make  segment  N  Invisible.  If  segment  N  Is  not  currently  visible,  l.e.,  POSTed,  no  action  Is 
taken.  UNPOST(O)  result*  In  UNPOSTIng  all  the  segments. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-04  8egment  N  doe*  not  exist  (for  N>0). 
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HIGHLIGHT  (  N,  C  ) 

Set  HIGHLIGHT  mode  for  segment  N.  Highlighting  may  be  Implemented  In  different  ways, 
such  as  blinking,  bold  width,  a  change  In  color  or  Intensity,  underlining  (for  text),  etc.  C  Is 
specified  as  an  Integer  value  as  follows: 


C«1  Highlight  Segment  N 
C  •  0  Normal  mode 

N«0  specifies  all  segments.  If  segment  N  does  not  exist,  this  call  results  in  an  error. 
Possible  errors: 

ERR-02  System  table  overflow. 

ERR-04  Segment  N  does  not  exist  (for  N>0). 

WmiMJLl 

Activate/deactivate  segment  N  for  detection  by  the  "touching"  device  (F»3).  K  Is 
specified  as  an  Integer  value. 


K  a  1  Activate  segment  N  for  "touching" 

K  a  o  Deactivate  segment  N  for  "touching" 

N«0  specifies  all  currently  defined  segments.  Newly  created  segments  are  not  touch 
sensitive  until  specifically  made  so.  Similarly,  when  an  existing  segment  Is  replaced  by  a 
new  one  with  the  same  ID,  the  new  one  is  not  touch  sensitive  until  explicitly  made  so. 
Upon  killing  a  segment,  touch-sensitivity  for  that  segment  terminates. 

When  HOLD  mode  is  on,  segments  that  are  UNPOSTed  or  KILLed  might  still  be  displayed. 
Only  segments  that  are  POSTed,  and  not  UNPOST-  or  KILL-pending,  and  TOUCH-sensItlve 
may  be  detected  by  the  touching  devico  (F*3). 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-04  Segment  does  not  exist. 

ERR-08  No  pointing  device  Is  available. 
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mu  i-N.  j 

Remove  segment  N  from  the  display  system.  UNPOST  the  segment  If  currently  POSTed, 
and  reclaim  Its  storage  and  ID.  This  Is  an  Irreversible  operation,  which  makes  the  system 
"forget"  about  segment  N.  KILL(O)  results  In  KILUng  all  currently  defined  segments. 

Possible  errors: 

ERR-02  System  table  overflow. 

ERR-04  Segment  N  does  not  exist  (for  N>0). 
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[S]  UPDATE  CONTROL 


THs  following  two  GL  calls  allow  the  application  to  control  undesirable  Intermediate 
updating  of  the  display.  If  theae  calls  are  not  used,  the  display  will  be  updated  and 
regenerated  for  eaoh  segment  ohanged  In  a  series  of  operations,  with  the  result  that 
Intermediate  or  Incomplete  pictures  may  be  displayed. 


HPIBJJU 

Hold/Don't  hold  subsequent  display  erasures.  Use  of  HOLD  mode  allows  the  user's 
application  program  to  group  display  erasures  such  that  they  occur  simultaneously.  (This 
feature  is  often  employed  to  minlml2e  "erasure  flash"  on  storage-tube  display  terminals.) 

When  in  HOLD  mode,  the  graphics  system  suspends  display  erasures  until  a  DONE  is 
Issued.  When  not  In  this  mode,  display  erasures  are  performed  aa  encountered. 

K  «  o  HOLD  mode  not  in  effeot. 

K  *  1  HOLD  mode  In  effeot. 

HOLD(O)  la  the  aystem  Initialization  default. 

Possible  errors: 

None. 


DONE 

Perform  all  pending  display  erasures.  This  does  not  modify  the  HOLD  mode. 
Poealble  errors: 


None. 
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{6]  GRAPHIC  FILE8 


The  following  GL  calls  allow  the  application  programmer  to  create  a  file  containing  e 
device-independent  description  of  one  or  more  user-named  segments  and  to  Incorporate 
the  contents  of  suoh  a  file  In  a  graphic  application.  Calls  ara  also  provided  so  that  the 
user  can  determine  file  specific  information. 


READ-PILE  (  FILENAME,  U,  H) 

Read  the  specified  graphic  file.  FILENAME  contains  the  name  of  the  file  as  a  text  string. 
U  and  H  contain  the  names  of  the  segments  by  which  the  unhlghllghted  and  highlighted 
portions  of  the  file  can  subsequently  be  Identified.  Segments  previously  named  either  U 
or  H  are  deleted  (KILLed).  Segments  U  and  H  are  left  in  the  Invisible  (UNPOSTed), 
nonhlghllghted  state.  The  file  Is  positioned  within  the  current  viewport. 

Possible  errors: 

ERR- 13  File  does  not  exist, 

File  could  not  be  opened  or  read, 

File  was  not  a  graphic  file,  or 
File  protocol  was  Incompatible. 


OPEN-OUTPUT-FILE  (  FILENAME.  COMMENT  ) 

Open  graphics  file  for  output.  FILENAME  contains  the  name  of  the  file  as  a  text  string; 
COMMENT  contains  a  user  specified  text  string.  The  comment  string  Is  added  to  the  file 
and  may  be  retrieved  by  READ-FILE-ATTRIBUTES. 

Possible  errors: 

ERR- 13  File  already  open,  or 

File  could  not  be  opened. 


WRITE-SEGMENT  (  N) 

Write  segment  N  In  the  currently  opened  output  file.  The  segment  is  placed  In  either  the 
unhlghllghted  or  highlighted  portion  of  the  file  depending  on  Its  highlight  state. 
WRITE-SEGMENT  (0)  results  In  writing  all  visible,  i.e.,  POSTed,  segments  In  the  file. 

Possible  errors: 

ERR-04  Segment  N  does  not  exist  (for  N>0). 

ERR- 1 3  No  output  file  open. 
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SkS.8g-9VTPVI-.SlS 

Close  the  currently  opened  graphics  output  file,  msklng  It  Available  for  graphics  Input. 
Possible  errors: 

ERR- 13  No  output  fils  open. 


REAP-FIIE-ATTRIBUTES  (  FILENAME,  X,  Y.  MAX-CHARS,  NO-CHARS.  COMMENT) 

Obtain  the  precision  and  comment  Information  from  a  graphic  file.  FILENAME  contains  the 
name  of  the  file  as  a  text  string,  while  MAX-CHARS  contains  the  maximum  number  of 
characters  that  can  be  returned  as  the  file  comment.  The  precision  of  the  file  is 
returned  as  Integers  In  X  and  Y,  and  Is  generally  used  In  conjunction  with  the  VIEWPORT 
command  for  controlling  placement  of  the  file  Input  on  the  display  surface.  The  file 
comment  is  returned  In  COMMENT  as  a  text  string.  NO-CHARS  is  set  to  the  number  of 
comment  characters  returned.  If  the  number  of  characters  of  the  file  comment  exceeds 
MAX-CHARS,  the  text  string  is  truncated  to  MAX-CHARS  characters  and  NO-CHARS  Is  set 
to  MAX-CHARS. 

Possible  errors: 

ERR- 13  File  does  not  exist, 

File  oould  not  be  opened  or  read, 

File  was  not  a  graphic  file,  or 
File  protoeol  was  Incompatible. 
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[7]  INFORMATION  ENQUIRY 


QL  maintains  and  makes  available  to  the  user's  application  program  an  Internal  status 
array  containing  Information  regarding  the  current  state  of  the  graphics  system  as  well 
as  the  characteristics  of  the  device  to  which  the  application  Is  connected.  This 
Information  permits  elements  of  the  application  program  to  save  significant  Information 
about  the  current  state  of  the  graphics  system,  Issue  GL  calls  that  alter  Its  state,  and 
subsequently  restore  the  graphics  system  to  Its  previous  state  (within  certain  limits).  It 
additionally  allows  the  application  program  to  determine  the  type  and  nature  of  any 
errors  that  have  occurred  during  the  execution  of  the  program  since  the  previous  access 
to  such  error  Information.  Finally,  It  allows  the  application  program  to  determine  specific 
features  about  the  device  to  which  It  Is  connected  In  order  to  optimize  visual 
presentation.  The  graphics  system  maps  application  program  graphic  calls  Into  features 
supported  by  the  display  device  to  which  It  Is  connected.  Th&  mapping  may  not  always 
be  optimal  for  a  given  application.  By  retrieving  device-specific  and  connection-specific 
information  from  the  enquiry  array,  the  application  program  can  determine  the  features 
available  and  tailor  Its  calls  to  achieve  Its  own  feature  mapping. 


ENQUIRE  (  K.  VALUE  ) 

\ 

Enquire  about  the  status  of  the  system  and  current  values  of  parameters.  The  system 
retains  state  information  In  an  array  that  Is  accessible  via  the  ENQUIRE  call.  The  enquiry 
call  copies  the  Kth  element  of  the  state  array  Into  VALUE.  Array  vallues  can  be  modified 
by  the  application  program  only  via  GL  calls  that  result  In  parameter  changes  and  by  the 
ERROR  call.  | 

The  following  list  specifies  the  parameters,  their  type,  and  the  sldej  effects  (If  any)  of 
the  ENQUIRE  call. 

ERROR  INFORMATION 

The  following  three  words  reflect  any  error  Information  logged  since  the  previous 
access  to  this  Information.  As  each  word  Is  accessed,  the  corresponding 
Information  Is  returned  to  the  user.  Subsequent  access  to  the  some  word  or 
Issuance  of  another  GL  call  that  accesses  any  other  Information  In  the  enquiry 
array  or  Invokes  any  other  graphic  function  results  In  the  error  Information  being 
updated  and  the  new  data  made  available. 

ARRAY[0]  Error  criticality.  (Integer) 


This  array  element  Indicates  the  criticality  of  errors  that  have  occurred 
since  the  last  access.  The  value  ranges  from  0  to  15  with  Individual 
bit-positions  taking  the  following  meanlngi 
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1 .  Warning:  Program  request  not  supported  due  to  nonexistent 
feature. 

2.  Minor  Error:  Possible  picture  distortion  or  minor  data  loss  (e.g., 
bad  parameter  value). 

3.  Serious  Error:  Major  data  loss  (e.g.,  system  table  overflow). 

4.  Petal  Error:  System  cannot  continue  (e.g.,  device  connection 
fellure). 

ARRAY[1]  Error  code.  (Integer) 

This  word  Indicates  the  accumulative  effect  of  errors  occurring  since  the 
last  access  to  the  error  Information  and  takes  a  value  from  0  to  05535. 
The  definition  of  Individual  bit-positions  are  contained  In  Appendix  B. 

ARRAY[2]  Error  subcode,  (integer) 

If  less  than  32000  the  ID  of  the  segment  in  error  for  the  moat  severe  error 
criticality  reported  (if  any  segment  wes  Involved).  Otherwlee,  an 
Implementation  dependent  code  giving  more  Information  about  the  moat 
severe  error. 

DEVICE  CHARACTERISTICS 

The  following  Information  provides  specific  Information  about  the  device  to  which 
the  application  la  connected. 

ARRAY[3]  Highlighting  availability.  (Integer) 

A  1  e-blt  field  Indicating  the  availability  of  highlighting  on  speclflo  scopes. 
The  low  order  bit  position  Indicates  highlighting  availability  on  scope  1  with 
progressively  higher  bit  positions  Indicating  highlighting  availability  on 
scopes  2  through  1 S. 

ARRAY[4]  Keyboard  availability.  (Integer) 

A  word  Indicating  whether  or  not  a  keyboard  la  available  to  the  application 
for  Input.  If  the  value  Is  nonzero,  then  a  keyboard  Is  available. 

ARRAY[5]  Positioning  availability.  (Integer) 

An  Integer  value  Indicating  whether  or  not  pointing  or  positioning  input  Is 
available.  If  the  value  Is  nonzero,  pointing  Input  Is  available. 

ARRAY[6]  Function  key  availability,  (integer) 


A  word  containing  a  count  of  the  number  of  function  keys  available  for 
function  key  Input. 
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ARRAY[7]  Touehlng  availability.  (Intagar) 

A  word  Indicating  whather  or  not  segment  touching  is  available.  The  value 
0  Indicates  that  aegmant  touching  Input  Is  unavailable;  1  Indicates  that 
segment  touching  is  supported  but  that  only  the  segment  Id  la  returned;  2 
Indicates  that  both  the  segment  Id  and  touch  location  are  returned. 

ARRAY[8]  Analog  device  availability.  (Intagar) 

A  word  Indicating  whether  or  not  analog  Input  capability  Is  available  to  the 
application  program.  If  the  value  is  nonzero,  then  an  analog  Input  device  Is 
available. 

ARRAY[9]  Cursor  availability.  (Integer) 

An  Integer  value  Indicating  whether  or  not  cursor  positioning  capability  Is 
available.  If  the  value  Is  nonzero,  cursor  positioning  Is  supported. 

ARRAY[10]  X  resolution.  (Integer) 

The  resolution  along  the  X-axis  of  the  allocation-viewport. 

ARRAY[  1 1  ]  Y  resolution.  (Integer) 

The  resolution  along  the  Y-axis  of  the  allocation-viewport. 

ARRAY[12]X  dimension,  (real) 

The  dimension  In  centimeters  along  the  X-axis  of  the  allocation-viewport. 
ARRAY[  1 9]  Y  dimension,  (real) 

The  dimension  In  centimeters  along  the  Y-axis  of  the  allocation-viewport. 

ARRAY[14]  X  port  max.  (real  >■  1.0) 

The  maximum  X  viewport  value  for  the  allocation-viewport. 

ARRAY[10]  Y  port  max.  (real  >■  1.0) 

The  maximum  Y  viewport  value  for  the  allocation-viewport. 

ARRAY[  10]  Number  of  scopes.  (Integer) 

A  16-blt  scope  mask  Indicating  the  scopes  available.  The  low  order  bit 
corresponds  to  scope  #1.  Successive  bits  correspond  to  scopes  2  through 
10. 
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ARRAY[1 7]  Osvlcs  cods.  (Integer) 

A  word  Indicating  the  graphics  device  type  (e.g.,  TEKTRONIX,  QENISCO). 

ARRAY[  18]  Device  type.  (Integer) 

A  word  Indicating  specific  display  properties  of  the  device. 

ARRAY[10  -  20]  Unused. 

COLOR  INFORMATION 

Color  Data  Request  Word 

ARRAY[21]  Color  Information  request  trigger. 

A  trigger  word  that  when  accessed  causes  requested  color  information  to 
be  stored  In  the  area  pointed  to  by  the  return  location  parameter  for  the 
enquiry  request.  The  type  of  color  Information  request  Is  Indicated  by 
specific  data  values  In  the  user-specified  area  as  follows! 

Wordl  ■  1  :  Enquire  on  scope  data. 

Word2  ■  Scope  number. 

Returns  In  word  3  the  number  of  entries  In  the 
color  table  for  this  scope.  (Words  1  and  2  left 
unchanged.) 

Wordl  ■  2  !  Enquire  on  color  entry  for  specified  ecope. 

Word2  ■  Scope  number. 

Word3  ■  Color  entry  number:  ranging  from  1  to  the  value 
returned  In  word  3  by  an  enquiry  on  scope  data 
request. 

Returns  In  words  4  through  8  the  following  (see 
COLOR  call). 

Word4;  Intensity  value.  (0.  <■  real  number  <■ 

1.) 


WordS:  Red  value.  (0.  <■  real  number  <■  1 .) 

Word  8:  Green  value.  (0.  <■  real  number  <■  1 .) 

Word7t  Blue  value.  (0.  <■  real  number  <■  1 .) 
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Word8: 


Highlight  Indicator.  (Intogor) 

1  Implloa  highlighting, 

0  Implloa  no  highlighting. 


Color  Dofault  Values 

These  values  are  used  by  OPEN  to  Initialize  a  segment.  They  are  set  at  system 
Initialization  time  (see  COLON)  and  may  be  reset  to  user-specified  values  via  the 
DEFAULT-COLOR  call. 

ARRAY[22]  Intensity  default.  (0.  <*  real  number  <■  1 .) 

A  real  number  from  0.  to  1 .  Indicating  the  OPEN  default  Intensity  setting. 

ARRAY[23]  Red  default.  (0.  <«  real  number  <■  1.) 

A  real  number  from  0.  to  1 .  indicating  the  red  color  default  value  for  OPEN 
processing. 

ARRAY[24]  Qreen  default.  (0.  <■  real  number  <■  1 .) 

A  real  number  from  0.  to  1.  Indicating  the  green  color  default  value  for  OPEN 
processing. 

ARRAY[25]  Blue  default.  (0.  <■  real  number  <■  1 .) 

A  real  number  from  0.  to  1 .  Indicating  the  blue  default  color  value  for  OPEN 
processing. 


Color  Status 

These  values  Indicate  the  current  color  settings  In  effect  from  the  last  COLOR 
caM. 

ARRAY[26]  Intensity  requested.  (0.  <■  real  number  <■  1 .) 

The  current  Intensity  setting  to  be  used  for  subsequent  graphic  primitives 
specified  for  the  currently  open  segment. 

ARRAY[27]  Red  value.  (0.  <■  real  number  <■  1.) 

The  current  red  color  value  setting  to  be  used  for  subsequent  graphic 
primitives  specified  for  the  currently  open  segment. 

ARRAY[28]  Qreen  value.  (0.  <■  real  number  <■  1.) 

The  current  green  color  value  setting  to  be  used  for  subsequent  graphic 
primitives  specified  for  the  currently  open  segment. 
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ARRAY[29]  Blue  value.  (0.  <■  real  number  <■  1.) 

The  current  blue  color  value  setting  to  be  used  for  subsequent  graphic 
primitives  specified  for  the  eurrently  open  segment. 

ARRAY[30]  Unused. 

TEXT  DATA  INFORMATION 

Text  Data  Request  Word 

ARRAY[ai]  Text  Information  request  trigger. 

A  trigger  word  that  when  accessed  causes  requested  text  font  Information 
to  be  stored  In  the  area  pointed  to  ty  the  return  location  parameter  for  the 
enquiry  request.  The  type  of  text  font  information  desired  Is  Indicated  by 
specific  data  values  in  tha  user-specified  area  as  follows: 

Wordl  ■  1  :  Enquire  on  text  faoe  data. 

Word2  ■  Face  entry  index:  a  value  ranging  from  0  (default 

text  face)  to  the  value  In  enquiry  array  entry  32 

(the  number  of  text  faces  supported  by  the  device. 

Returns  In  words  3  and  4  the  following: 

Words  -  the  name  designation  (e.g.,  BODONI, 
TIMES  ROMAN)  for  this  text  face  (see 
Appendix  C). 

Word4  -  the  number  of  fonts  supported  for  this 
text  face. 

(The  values  In  words  1  and  2  are  left  unchanged.) 
Wordl  ■  2  :  Enquire  on  text  font  data. 

Word2  ■  Face  entry  Index  (see  above). 

Word3  ■  Ignored. 

Word4  ■  Font  Index  value:  a  value  ranging  from  0  (tha  default 
text  font  for  this  text  face)  to  the  value  returned  In 
the  Enquire  on  Face  Data  request. 

Returns  In  words  5  through  28: 

WordB  -  font  quality  code. 

Words  -  text  character  height  In  window  unite 
(reel). 
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Word 7  -  text  character  width  In  window  units 

(real). 

Word8  -  default  Intercharacter  vertical  spacing 

for  this  text  font  In  window  units 
(rosl). 

WordO  -  default  Intercharacter  horizontal 

spacing  for  this  text  font  In  window 
units  (real). 

Word  1 0  -  character  base  line  offset  In  window 
units  from  the  base  of  the  character 
•  envelope  (real). 

Word  1 1  through  Word20  -  IB  consecutive  10-blt  words  that 

when  catenated  represent  a  250-blt 
string  Indicating  the  availability  of 
Individual  characters  for  the  specified 
face  and  font. 

Text  Face  Count  Word 

ARRAY[32]  Number  of  text  faces.  (Integer) 

The  number  of  text  faces  supported  by  this  device.  This  Is  the  maximum 
value  that  may  be  specified  for  the  text  face  Index  In  the  previous  text 
Information  request  mechanism. 

Oefault  Text  Face/Font  Parameters 

The  current  OPEN  default  values  for  text  attributes  as  specified  during  system 

Initialization  or  via  the  DEFAULT- TEXT  command. 

ARRAY[33]  Face  default.  (Integer) 

The  current  text  face  default  value  for  OPEN  processing. 

ARRAY[34]  Text  quality  default,  (integer) 

The  current  text  quality  default  value  for  OPEN  processing. 

ARRAY[35]  Text  height  default,  (real) 

The  current  character  height  default  value  for  OPEN  processing  In  window 
units. 
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ARRAY[36]  Text  width  default,  (real) 

The  currant  character  width  default  value  for  OPEN  proceaalng  in  window 
unite. 

ARRAY[37]  Text  vertical  spacing  default,  (real) 

The  current  Intercharacter  vertical  spacing  default  value  for  OPEN 
processing  In  window  units. 

ARRAY[38]  Text  horizontal  spacing  default,  (real) 

The  current  Intercharaeter  horizontal  spacing  default  value  for  OPEN 
processing  in  window  units. 

ARRAY[30]  Unused. 

User-requested  Text  Face/Font  Parameters 

The  most  recently  requested  text  font  values  as  specified  via  the  TEXTFACE 
command  or  as  a  consequence  of  OPEN  default  processing.  These  values  are 
used  for  text  clipping  and  intercharacter  positioning.  They  specify  the  desired 
text  font  values  with  the  height  and  width  values  indicating  the  maximum 
acceptable  for  a  selected  text  font.  The  actual  size  of  the  text  selected  (as 
Indicated  In  words  62  -  66  of  the  enquiry  array)  may  differ  from  these  values. 

ARRAY[40]  Face  value.  (Integer) 

The  last  value  of  the  text  face  requested  for  the  currently  open  segment 
via  the  TEXTFACE  command  or  via  OPEN  default  processing. 

ARRAY[41]  Text  quality  value.  (Integer) 

The  requested  quality,  e.g.,  hardware  or  software. 

ARRAY[42]  Text  height  value,  (real) 

The  requested  character  height  In  window  units. 

ARRAY[43]  Text  width  value,  (real) 

The  requested  cheracter  width  In  window  units. 

ARRAY[44]  Text  vertical-spacing  value,  (real) 

The  requested  Intercharacter  vertical  spacing  In  window  units. 

ARRAY[45]  Text  horlzontel-spaclng  value,  (real) 


The  requested  mteroheracter  Itorlzontel  spacing  In  window  unite. 
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ARRAY[46  >  47]  Unused. 

Currently  Selected  Text  Face/Font  Information 

The  following  apply  to  the  text  font  selected  by  the  syatem  In  reaponae  to  a 
user*  or  system-issued  TEXTFACE  command. 

ARRAY[46]  Text  face  Index.  (Integer) 

The  Index  value  for  the  currently  selected  text  face.  (See  enquiry  array 
word  31.) 

ARRAY[49]  Text  face  code,  (integer) 

A  code  Indicating  the  name  of  the  currently  selected  text  face  (e.g., 
BOOONI). 

ARRAY[50]  Text  font  Index.  (Integer) 

The  font  index  value  for  the  currently  selected  text  font.  (See  enquiry 
array  word  31.) 

ARRAY[51]  Text  quality. 

A  word  Indicating  the  type  of  the  text  that  has  been  selected,  e.g., 
hardware,  software. 

ARRAY[52]  Character  height,  (real) 

The  character  height  In  window  units  for  the  currently  selected  text  font. 
ARRAY[53]  Character  width,  (real) 

The  character  width  in  window  units  for  the  currently  selected  text  font. 

ARRAY[54]  Character  vertical  spacing,  (real) 

The  intercharacter  vertical  spacing  default  value  In  window  units  for  the 
currently  selected  text  font. 

ARRAY[55]  Character  horizontal  spacing,  (real) 

The  Intercharacter  horizontal  spacing  default  value  In  window  units  for  the 
currently  selected  text  font. 

ARRAY[50]  Character  base  line  offset,  (real) 

The  distance  In  window  units  above  the  bottom  of  the  character  of  the 
base  line  for  the  character-set. 
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ARRAY[57]  Unused. 

ASCII  character  availability 

16  consecutive  18-blt  words  that  when  catenated  represent  a  258-blt  string 
Indicating  the  availability  of  Individual  characters  for  the  currently  selected  text 
font. 

ARRAY[58]  Character  availability.  (Integer) 

ARRAY[59]  Character  availability.  (Integer) 

ARRAY[60]  Character  availability.  (Integer) 

ARRAY[61]  Character  availability.  (Integer) 

ARRAY[62]  Character  availability.  (Integer) 

ARRAY[63]  Character  availability.  (Integer) 

ARRAY[64]  Character  availability.  (Integer) 

ARRAY[66]  Character  availability.  (Integer) 

ARRAY[66]  Character  availability.  (Integer) 

ARRAY[67]  Character  availability.  (Integer) 

ARRAY[68]  Character  availability.  (Integer) 

ARRAY[8B]  Character  availability.  (Integer) 

ARRAY[70]  Charsoter  availability.  (Integer) 

ARRAY[71]  Charsoter  availability.  (Integer) 

ARRAY[72]  Charsoter  availability.  (Integer) 

ARRAY[73]  Charsoter  availability.  (Integer) 

ARRAY[74  -  78]  Unused. 

FACILITIES  ENABLED  INFORMATION  WORD 

ARRAV(  79]  Facilities  enabled.  (Integer) 

A  16-blt  word  Indicating  enabled  facilities.  A  1  -bit  In  the  l-th  bit  from  the 
right  indloates  the  l-th  faelllty  Is  enabled. 
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CURRENT  SCOPE  OATA 

ARRAY[80]  Scopes  used.  (Integer) 

A  word  Indlcstlng  the  scopes  currently  selected.  The  low-order  16  bits 
correspond  to  the  Individual  scopes  selected  with  the  low-order  bit 
Indlcstlng  scope  #1  is  selected  and  successive  bits  Indicating  which  of 
scopes  2  through  10  are  selected.  A  "1“  value  for  the  corresponding  bit 
position  Indicates  that  the  scope  Is  selected. 

CURRENT  WINDOW  VALUES 

The  following  four  values  (In  user  coordinates)  define  the  current  clipping  window. 
They  are  set  via  the  WINDOW  call  or  defaulted  by  the  system  Initialization 
process. 

ARRAY[61]  Window  XL.  (real) 

The  coordinate  of  the  left-hand  edge  (X  left)  of  the  clipping  window. 
ARRAY[82]  Window  YB.  (real) 

The  coordinate  of  the  bottom  edge  (Y  bottom)  of  the  current  clipping 
window. 

ARRAY[83]  Window  XR.  (real) 

The  coordinate  of  the  right-hand  edge  (X  right)  of  the  current  clipping 
window. 

ARRAY[84]  Window  YT.  (real) 

The  coordinate  of  the  top  edge  (Y  top)  of  the  current  clipping  window. 
CURRENT  VIEWPORT  VALUES 

The  following  four  values  Identify  the  current  viewport  to  which  the  clipping 
window  will  be  mapped.  They  are  specified  via  the  VIEWPORT  call  or  are 
defaulted  via  the  system  Initialization  process  as  described  In  the  VIEWPORT 
discussion. 

ARRAY[85]  Port  XL  (real) 

The  left-hand  edge  (X  left)  of  the  currently  selected  viewport  in  viewport 
units. 

ARRAY[88]  Port  YB.  (real) 

The  bottom  edge  (Y  bottom)  of  the  ourrently  seleoted  viewport  In  viewport 

units. 
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ARRAY[87]  Port  XR.  (roal) 

Tho  right-hand  adgs  (X  right)  of  tho  ourrantly  aelootod  viewport  In 
viewport  unlta. 

ARRAY[88]  Port  YT.  (real) 

The  top  edge  (Y  top)  of  the  ourrently  aelected  viewport  In  viewport  units. 
CURRENT  BEAM  VALUES 

ARRAY[89]  X  beam  value,  (real) 

The  X  coordinate  of  the  current  beam  location  in  window  units. 

ARRAY[80]  Y  beam  value,  (real) 

The  Y  coordinate  of  the  current  beam  location  In  window  units. 

ARRAY[01  -  07]  Unused. 

MISCELLANEOUS 

ARRAY[98]  Hold  mode  setting.  (Integer) 

0  Indicates  hold  mods  not  In  effect,  1  Indicates  hold  mode  active. 

ARRAY[99]  Sense  Distance,  (real) 


The  sense  distance  In  oentlmetera  as  specified  via  the  SENSE  call. 
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(8]  CRAPHIC  INPUT 


Ths  system  has  4  main  input  facilities. 


( 1 )  Positioning 

(2)  Function  keys 

(3)  Segment  Touching 

(4)  Analog  device 

Each  facility  can  be  either  ENABLEd  or  DISABLEd  (l.e.,  not-ENABLEd).  The  Initialization 
default  disables  all  the  Input  facilities. 

All  user  actions  at  the  display  terminal  regarding  a  disabled  facility  are  Ignored.  All  user 
actions  regarding  any  enabled  facility  are  queued  until  requested  by  the  application 
program.  In  addition,  the  application  program  can  check  for  availability  of  any  Input. 


Enable  Input  facility  "F",  where: 


F*1  means  pointing. 

F*2  means  function  key. 

F«3  means  segment  touching. 

F»4  means  analog  device. 

"F"  Is  always  specified  as  an  Integer.  Other  nonzero  values  of  “F"  may  be  added,  but 
the  “standard"  display  device  Is  not  guaranteed  to  support  them.  Values  of  "F"  above 
10  may  be  used  for  private  devices,  specific  to  a  system.  ENABLE(F)  takes  no  action  If 
the  facility  “F"  Is  already  enabled. 

For  ENABLEO).  the  user  must  also  tell  the  system  which  segments  should  be  checked 
and  within  which  sensitivity  aperture  (the  maximum  distance  between  the  curaor  and  any 
portion  of  a  display  segment,  for  detection  of  “touching").  For  more  details  see  SENSE 
and  TOUCH.  A  segment  Is  checked  for  being  touched  only  If  It  is  both  (I)  touch  sensitive 
(by  the  TOUCH  call)  and  (II)  POSTed. 

Possible  errors: 

ERR-08  The  facility  "F"  Is  not  available  (for  0<F<4). 


GRAPHICS  LAMOUAQf  CALLS 
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PIIABtf  t  r  ? 

Disable  ths  Input  facility  "F"  as  defined  abova.  DISABLE(O)  disables  all  Input  faollltiaa. 
The  system  Initialization  dafault  la  DISABLE(O).  When  a  facility  la  dlaabled,  all  queued 
Input  from  that  facility  Is  cleared.  DISABLE(F)  takea  no  action  If  the  facility  "F"  la  not 
enabled. 

Poaalble  error  a: 

ERR-00  Tha  facility  "F"  Is  undefined  (for  0<F<4). 


SENSE  (  D ) 

Oeflne  the  sensitivity  distance  for  the  device  used  fo*”  the  touching  facility.  D  specifies 
this  distance  In  centimeters  (as  a  real  number).  The  system  default  value  Is  $ENSE(.3), 
or  about  1  /8  of  an  Inch.  Implementations  are  allowed  to  deviate  from  the  value  of  D  up 
to  SO  percent  (to  allow  simple  distance  computation,  without  the  need  to  evaluate 
square  roots,  etc.).  For  soma  particular  Input  devices  (e.g.,  hardware  llghtpena),  this  call 
may  have  no  effect. 

Possible  errors: 

ERR-07  0<0. 

ERR-08  No  pointing  devioe  Is  available. 


laevr  uiY.  r.  is,  *.  r ) 

Get  Input  from  the  device.  When  this  call  Is  Issued,  a  nonzero  value  of  "W"  specifies 
that  the  system  should  wait  for  the  next  available  Input.  A  zero  value  for  "W"  specifies 
that  the  system  should  not  wait,  and  If  no  Input  Is  available,  this  should  be  indicated  (by 
the  system  to  the  calling  program)  by  setting  "F"  to  zero. 

Upon  return,  "F"  la  sat  by  tha  system  either  to  a  nonzero  value  Identifying  the  Input 
facility,  or  to  zero  If  It  was  called  with  W*0  and  no  Input  was  queued. 

FOR  POSITION  INPUT  (F»1),  X  and  Y  (real  numbers),  are  set  to  tha  appropriate  valuaa  In 
tha  uaor'a  (WINDOW)  coordinate  system.  K  Is  undefined. 

FOR  FUNCTION  KEY  INPUT  (F«2),  K  (Integer)  Is  sot  by  tha  aystam  to  tha  Integer 
corresponding  to  the  key.  X  and  Y  are  undefined. 

FOR  SEGMENT  TOUCHING  INPUT  (F«3  or  F»*3),  K  Is  set  by  the  system  to  the  ID  of  the 
aegment  that  was  touched,  and  X  and  Y  (real  numbers)  are  set  to  the  position  at  which 
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the  touch  was  dstsctsd.  Dsvlcss  that  cannot  supply  ths  X  and  Y  of  ths  touch  do  not 
modify  ths  vsluss  of  X  and  Y.  The  ENQUIRE  call  Is  used  to  determine  if  the  device  Is 
capable  of  supplying  the  X  and  Y  of  the  touch.  Only  the  first  touch  of  any  segment  Is 
reported.  If  several  segments  are  touched,  each  Is  reported,  in  an  arbitrary  order.  In 
order  to  retrieve  all  of  them,  multiple  INPUT  calls  must  be  Issued.  When  multiple  touching 
occurs,  all  touches  are  reported  with  F»-3,  except  the  last  one,  which  Is  reported  with 
F*3. 

FOR  ANALOG  INPUT  (F«4),  X  Is  set  to  the  normalized  value  of  the  device  between  0.  and 
1..  Y  and  K  are  undefined. 

When  a  facility  Is  disabled,  all  Its  queued  Inputs  are  oleared. 

Possible  errors: 

ERR- 10  No  facility  enabled  or  only  touch  facility 
enabled  but  no  segments  touch  enabled. 


lUMWI  LAN0UA8E  CAUS 
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(•]  DEFAULT  MODIFICATION 


The  following  calls  permit  the  application  program  to  modify  tha  standard  OPEN  dsfault 
settings  for  color  and  text  faca.  By  setting  tha  default  values  to  hla  moat  commonly  used 
values,  the  application  programmer  oan  reduce  the  amount  of  work  the  system  must 
perform  as  well  as  reduee  the  number  of  GL  calls  hla  program  must  Issue. 


DEFAULT-COLOR  (  I.  R.  0.  B  ) 

Reset  the  default  color  values  for  open  processing  from  the  current  default  values  to  the 
specified  values.  The  value  range  for  Individual  parameters  Is  the  earns  as  for  the  COLOR 
call. 

Possible  errors: 

None. 


DEFAULT-TEXT  (MASK.  NAME.  OUAL.  HEIGHT.  WIDTH, _ VEpTICA|.-BpACINGA 

HORIZONTAL-SPACING) 

Set  the  default  text  face  values  for  open  processing  to  the  Indicated  values.  This 
routine  changes  the  open  default  values  for  the  text  face  from  the  system  default 
values  to  the  specified  values.  The  value  range  for  Individual  parameters  Is  the  same  as 
for  the  TEXTFACE  call.  The  Individual  fields  are  Identical  to  those  defined  for  the 
TEXTFACE  command.  Fields  for  which  the  corresponding  mask  bit  Is  not  sot  assume  the 
default  values  for  the  most  closely  matching  text  font. 


Possible  errors: 
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[10]  SCOPE  SELECTION 


Th«  following  QL  call  allowa  the  application  program  to  apedfy  the  acope(a)  on  which 
aubaequently  defined  aegments  will  appear.  Individual  scopes  may  support  different 
color  sets  and/or  highlighting.  Depending  upon  the  device  type,  Individual  scopes  may  be 
physically  separate  from  each  other  or  may  overlay  one  another  (e.g.,  the  Qenlsco), 
permitting  capabilities  such  as  transparent  overlays  and  overlay  precedence. 


Bfi/mL-gCfiEE  ( U 

Display  aubaequently  OPENed  segments  on  the  Identified  scopes.  L  Is  a  scope  mask;  the 
Mh  bit  from  the  right  Identifies  the  l-th  scope.  The  system  Initialization  default  la  to 
enable  all  available  saopes. 

Possible  errors: 

ERR-07  Invalid  scope  mask  L. 
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(11]  MISCELLANEOUS 


The  following  GL  calls  provide  additional  capabilities  to  tha  application  programmer  that 
may  bo  useful  In  some  circumstances  but  are  generally  not  required  for  the  development 
of  graphic  application  programs. 


CURSOR  (  X.  Y  ) 

Position  the  cursor,  If  possible,  at  tha  specified  point.  If  a  cursor  Is  displayed  (l.e.,  for 
touching  or  positioning)  this  call  allows  the  user  to  move  the  cursor  to  the  point  specified 
by  (X.Y),  given  in  user's  (WINDOW)  coordinates  (real  numbers). 

If  the  specified  point  Is  outside  of  the  window,  the  cursor  Is  positioned  at  the  window 
edge.  If  the  above  devices  are  not  enabled,  or  If  the  hardware  does  not  support  cursor 
positioning,  no  action  Is  taken. 

Possible  errors: 

Nona. 


ESCAPE  (  CPPE,  AqquqEHT-piT-8TpiNQ,  RE8ULT-PIT-8TRIHG  ) 

Bypass  standard  graphics  system  processing  to  send  raw  data  directly  to  the  specified 
escape  function.  This  GL  call  provides  a  handle  by  which  Installation-specific  options 
may  be  Introduced  Into  the  graphics  system. 

CODE  (an  Integer)  Is  the  name  of  the  function  to  be  executed.  ARGUMENT-BIT-STRING  Is 
the  location  of  the  bits  to  be  transmitted  to  the  specified  escape  function. 
RESULT-BIT-STRING  Is  the  location  at  which  any  response  from  the  specified  ESCAPE 
function  Is  to  be  returned.  The  number  of  bits  required  for  any  given  ESCAPE  function 
and  the  Interpretation  of  the  bit  atream  data  Is  dependent  upon  the  particular  function 
Involved.  Thla  call  may  or  may  not  be  Implemented  In  any  given  ayatem,  and  the  function 
COOEa  are  devlce/ayatem  dependent. 

Poaalble  error  a: 

ERR-05  The  COOE  Is  unknown  to  the  display  system. 

Any  other  error  (e.g.,  ayatem  table  overflow). 
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ERROR  (  ERROR.  SUBCODE.  CRITICALITY  ) 

Sot  tho  enquiry  array  error  information  according  to  the  Indicated  values.  (See  ENQUIRE 
discussion.)  ERROR  and  CRITICALITY  are  ORed  into  their  respective  fields  In  the  enquiry 
array.  SUBCOOE  replaces  the  equivalent  field  In  the  enquiry  array  only  If  CRITICALITY  Is 
greater  then  the  criticality  for  ell  errors  that  have  occurred  since  the  last  time  error 
Information  was  reported  to  the  user. 

Possible  errors: 

None. 


SYNCHRONIZE 

Interpret  all  previously  Issued  Graphic  Language  commands  and  complete  all  pending 
Graphics  System  tasks. 

Possible  errors: 

None. 


Appendix  A 

FORTRAN  LANGUAGE/TERMINAL  INTERFACE 


The  following  describes  the  programmer's  Interface  and  device  specific  Information 
necessary  for  FORTRAN- 10  users  of  Grsphlcs  Language  on  TENEX/TOP8-20. 


DEVICE  CONNECTION  INITIATION  AND  TERMINATION 


DINIT(CONFIGURATION-STRING, ASPECT-RATIO) 

The  first  parsmeter  Is  a  string,  the  second  a  real  number.  CONFIGURATION-STRING 
consists  of  one  or  more  of  the  following  keyword  parameters  separated  by 
eommas: 


BACKEND- (TYPE  [.HOST]) 

DEVICE- (CONNECTION, DISPLAY-ADDRESS ( ,01 SPLAY-SUB ADORESS] ) 

IN!  TF!LE-(S-T-C00E{, FILENAME! ) 

where  [...]  Indicates  an  optional  parameter.  Eaoh  keyword  parameter  Is  described 
below. 


BACKEND«(TYPE[,HOST]) 


This  parameter  tads  the  Graphics  System  the  type  of  display  oode  and  the 
host  on  which  the  display  code  Is  to  be  generated.  Acceptable  valuea  for 
TYPE  Inolude: 


GEN! SCO 
GENISCO-SO 

TEKTRONIX 

TK4027 

HP2648 

HP3872 

AE0S12 


-  for  ths  GENISCO  GCT-3000 

-  for  s  apacial  configuration  GENISCO 
GCT-3000  uasd  by  Situation  0 lap  I  ay 

-  for  ths  Tektronix  4010,  4012,  and  4014 

-  for  ths  Tektronix  4027 

-  for  the  How  I  at t -Packard  HP-2648A 

-  for  ths  HsHlett-Packard  HP-9872A 

-  for  ths  Advanced  Electronic  Oselgn  S12 


Normally,  the  Graphics  System  generates  display-device  orders  on  the 
seme  host  on  which  the  user's  graphic  application  program  runs.  The  user 
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csn  cause  the  Qrephlcs  System  to  generate  display  device  orders  on 
snother  host  (e.g.,  a  Remote  Site  Module)  by  specifying  the  optional  HOST 
parameter.  To  do  this,  HOST  should  be  the  ARPANET  hostname  of  a  host 
containing  a  Qrephlcs  System  Backend  Server. 


0EVICEm(C0NNECTI0N,DI8PLAY-ADDRESS[,DI8PLAY-SUBADDRES8]) 

This  parameter  tells  the  Graphics  System  where  the  display  device  la 
located  and  how  the  device  connection  Is  to  be  made.  CONNECTION 
specifies  the  protocol  to  be  used  to  connect  to  the  device.  Three 
protocols  are  supported: 

0  -  Direct  connection  for  local  and  TIP  attached  displays. 

S  -  Server  connection  for  displays  connected  to  remote  hosts. 

L  -  Special  purpose  DMA  connection. 

DISPLAY-ADORESS  Is  the  physical  address  of  the  display  device.  For 
TENEX/TOPS-20  this  Is  a  device  dealgnator,  typically  TTY:  or  TTYddd: 
where  ddd  Is  the  terminal  number.  For  ARPANET  "wild"  TIP  connected 
display  devices,  the  device  designator  Is: 

NET  :ls.tlp-ts$T 

where  "Is"  Is  a  job-relative  local  socket  number  such  as  the  number  1, 
"tip”  Is  the  name  of  the  TIP  to  which  the  terminal  Is  attached,  and  HtsM  Is 
the  octal  number,  (portnumber)*2t18  ♦  3.  (As  an  example,  port  IS  on 
USC-TIP  would  be  NET:1.USC-TIP-3200003;T.)  (See  the  ARPANET  HTIP 
Users  Guide"  or  Appendix  E  for  additional  Information.)  For  ARPANET  server 
connected  display  devices,  the  device  designator  Is: 

NET  :ls.host-fs;T 

where  "Is"  Is  a  job-relative  local  socket  number  such  as  the  number  1, 
"host"  Is  the  ARPANET  host  name  to  which  the  terminal  Is  attached,  and 
"fs"  Is  the  server's  listening  socket  number.  (As  on  example,  a  display 
device  on  ACCAT-UNIX  that  had  a  server  listening  on  socket  77  would  be 
NET:  1  .ACCAT-UNIX-77jT.) 

DISPLAY-SUBADDRESS  Is  an  Integer  that  may  be  used  to  distinguish 
between  multiple  display  devices  at  the  same  physical  address,  e.g., 
multiple  display  devices  served  by  a  server  or  multiple  work  stations  on  a 
single  display  device. 


INITFILE*(3-T-C00E[,FIIENAME]) 

This  parameter  allows  the  user  to  Include  CONFIGURATION-STRING 
parameters  from  a  file.  The  contents  of  the  specified  file  replace  the 
INITFILE«(...)  In  the  CONFIGURATION-STRING  parameter.  The  file  may 
contain  any  CONFIGURATION-STRING  parameter(s)  except  another 
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INITFILEa(...)  parameter.  S-T-COOE  can  ba  one  of  the  following: 


T  -  Obtain  the  filename  for  the  Included 
file  from  the  uear’s  primary  TTVi 
F  -  Use  the  FILENAME  parameter  for  the  name 
of  the  included  file. 

FILENAME  la  praaant  only  for  S-T-COOE  »F  and  contain#  the  name  of  the 
Included  fHe. 


Example#: 

The  following  are  examplea  of  DINIT  calla.  In  all  example#,  "-1."  le  used  ae 
the  desired  aspect-ratio  value  to  Indicate  that  the  device  default 
aspect-ratio  Is  to  be  used.  To  use  a  Tektronix  4014  attached  either 
directly  to  a  host  or  to  a  TIP  both  as  the  login  device  and  as  the  graphlos 
terminal,  code: 

CALL  DINIT  CBACKEND«(TEKTRONIX),DEVICE»(D,TTY:),,-1.) 

To  uae  a  Tektronix  4027  terminal  attached  to  terminal  port  1 07,  code: 

CALL  DINIT  ('BACKENDa(TK4027),DEVICE«(D,TTY107:)',-1.) 

To  use  a  HP-2B48A  terminal  attached  to  the  NPS-TIP  port  5  with  thet  port 
set  In  "wild"  mode,  code: 

CALL  DINIT  OBACKEND-(HP2048), DEVICES, NET:  1  .NPS-TIP- 1 200003tT)',-1 .) 

To  uae  GENISCO  display  2  at  ACCAT-UNIX  with  display  code  generated  at 
the  application  program  host,  code: 

CALL  DINIT('BACKEND*(GENISCO),OEVICE»(S,NET:1.ACCAT-UNIX-77;T,2)',-1 .) 

If  any  of  the  above  CONFIGURATION-STRINGs  was  kept  in  the  file  "Too", 
then  code: 


CALL  DINIT  (,INITFILE*(F,F00),,-1 .) 


or  code: 


CALL  DINIT  <MNITFILE«(T)\-1.) 


and  enter  FOO  on  the  primary  TTY:  whi 


for  the  INITFILE  filename. 
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OREL 

RgIggsg  ths  display  da  vie  a  balng  used. 


VIEWING  AREA  AND  COORDINATE  SYSTEM  SELECTION 

DPORT  (XL,  YB,  XR,  YT) 

Define  tha  area  of  the  CRT  to  be  used  by  the  system.  All  the  arguments  are  real 
numbers. 


DWINOO  (XL,  YB,  XR,  YT) 

Define  the  user  coordinate  system.  All  the  arguments  are  real  numbers. 


SEGMENT  SPECIFICATION 


OOPEN  (N) 

Initiate  specification  of  a  segment  with  ID  N.  The  ID,  N,  Is  an  Integer  between  1 
and  32000. 


DCLOSE 

Terminate  specification  of  the  currently  open  segment. 


OCOLOR  (I,  R.  G,  B) 

Set  the  Intensity  end  chromatlclty  (hue  and  saturation)  for  the  remainder  of  this 
segment.  I,  R,  G,  end  B  are  real  numbers. 


DINT  (I) 

Set  the  Intensity  level  for  the  remainder  of  this  segment.  I  Is  specified  as  a  real 
number. 


DTFACE  (M,  F,  Q,  H,  W,  VS  ,HS) 

Set  text  face/font  for  the  remainder  of  this  segment.  H,  W,  VS  and  HS  are 
specified  In  window  units  (real  numbers)  and  Indicate  the  desired  height,  width, 
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vertical-spacing  And  horizontal-spacing  values  for  the  character  font  selected.  Q, 
an  Integer,  specifies  the  quality. 


DOOT  (X,  V) 

Olsplay  a  dot  at  the  specified  position  (In  the  user's  coordinate  system).  X  and  Y 
ere  given  es  reel  numbers. 


DDRAW  (X.  Y) 

Drew  e  line  from  the  current  beam  position  to  the  specified  position,  x  and  Y  ere 
given  as  real  numbers. 

DMOVE  (X.  Y) 

Move  the  beam  position  to  the  specified  point,  without  any  drawing.  X  and  Y  ere 
given  as  real  numbers. 


DUNE  (X,  Y,  I) 

DMOVE  or  DRDRAW.  If  1*0,  then  this  call  Is  equivalent  to  DMOVE(X.Y),  otherwise  It 
Is  equivalent  to  DDRAW(X.Y).  As  In  DMOVE(X.Y)  and  DDRAW(X.Y),  X  and  Y  are 
supplied  as  real  numbers  In  absolute  coordinates.  I  Is  given  as  an  Integer. 

DARC  (X,  Y,  R,  SA.  EA) 

Draw  a  circular  arc  with  radius  R  around  the  point  (X.Y)  starting  at  the  angle  SA, 
counter-clockwise  ending  at  angle  EA.  All  arguments  are  real  numbers. 


DRDOT  (DX,  DY) 

Display  a  dot  in  the  position  specified  relative  to  the  current  beam  position.  DX 
and  DY  are  given  as  real  numbers. 


DRDRAW  (DX,  DY) 

Draw  a  line  from  the  current  beam  position  to  the  point  (X*DX,Y*DY)  where  (X,Y)  is 
the  beam  position  before  the  call-  DX  and  DY  are  given  as  real  numbers. 


DRMOVE  (DX.  DY) 

Move  the  beam  position  from  the  current  beam  position  (X,Y)  to  (X*DX,Y*DY) 
without  any  drawing.  DX  and  DY  are  given  as  real  numbers. 


ONLINE  (OX,  DY,  I) 

DRMOVE  or  DRDRAW.  If  Iso  then  this  call  Is  equivalent  to  DRMOVE(DX.DY), 
otherwise  It  Is  equivalent  to  ORDRAW(DX,DY).  As  In  DRMOVE(DX.DY)  and 
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DRDRAW(DX.DY),  OX  snd  OY  art  given  as  roal  numbers  in  relative  coordinates.  I  Is 
given  as  an  Integer. 


DRARC  (R,  SA,  EA) 

Draw  a  circular  arc  with  radius  R  around  the  current  beam  position  starting  at  the 
angle  SA,  counter-clockwise  ending  at  angle  EA.  All  arguments  are  real  numbers. 


OTEXT  (N,  STRING-POINTER) 

Show  a  text  string  starting  at  the  current  beam  position.  N  Is  an  Integer  value 
Indicating  the  number  of  characters  In  the  text  string  pointed  to  by  a 
string-pointer.  The  string-pointer  may  be  established  either  via  an  array 
reference  to  an  array  containing  the  text  string  or  via  specification  of  the  text 
string  as  a  literal  In  the  OTEXT  call. 

DFILLS  (X,  Y,  R,  SA.  EA,  MODE,  ANGLE,  DIST) 

Fill  the  specified  sector  of  a  circle.  MODE  Is  an  Integer  and  the  remaining 
arguments  are  real  numbers. 


DFILLP 

Begin  polygon  definition. 

DVERTX  (X,  Y) 

Define  polygon  vertex.  X  and  Y  are  real  values. 


DFILLX  (MODE.  ANGLE.  DIST) 

Terminate  polygon  specification  and  fill  according  to  Indicated  parameters.  MODE 
Is  an  Integer  indicating  the  type  of  filling  desired.  ANGLE  and  DIST  are  real 
numbers  Indicating  the  hatch  angle  and  Inter-hatch-mark  spacing. 


SEflMENLWNm 


DMERGE  (M,  N) 

Merge  segment  M  Into  segment  N.  The  IDs,  M  and  N,  must  be  Integer  values 
between  1  and  32000. 


DPOST  (N) 
Dlapli 


pent  N  on  the  CRT.  The  ID,  N,  Is  an  Integer  between  0  and  32000. 
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DNPOST  (N) 

Stop  displaying  segment  N  on  the  CRT.  The  ID,  N,  Is  an  Integer  between  0  end 
32000. 

OHLGHT  (N,  C) 

Set  HIGHLIGHT  mode  for  segment  N.  The  ID,  N,  Is  an  Integer  between  0  and 
32000.  C  Is  specified  as  an  Integer. 

DTOUCH  (N,  K) 

Activate/deactivate  the  existing  segment  N  for  "touching"  by  the  device  F»3.  N 
end  K  are  Integera. 


DKILL  (N) 

Remove  aegment  N  from  the  display  system.  The  ID,  N,  Is  en  Integer  between  0 
end  32000. 


UPDATE  C9NTRPL 


DHOLD  (K) 

Hold/don't  hold  aubsequent  display  erasures.  K  Is  an  Integer  value. 


DDONE 

Update  acreen  to  reflect  current  segment  stetus. 


GRAPHIC  FILES 


DFILEI  (FILENAME,  U,  H) 

Read  the  specified  graphic  file.  FILENAME-POINTER  points  to  e  text  string 
contelnlng  the  filename.  U  and  H  are  the  segment  IDs  for  the  UNHIGHLIGHTED  end 
HIGHLIGHTED  portions  of  the  file.  Both  are  Integers  between  1  and  32000. 


DFOPEN  (FILENAME-POINTER,  N,  COMMENT-POINTER) 

Open  graphics  file  for  output.  FILENAME-POINTER  and  COMMENT-POINTER  point  to 
text  etrlngs  contelnlng  the  filename  and  the  file  comment.  N,  an  Integer,  specifies 
the  number  of  characters  In  the  file  comment. 
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DFWRTE  (N) 

Write  segment  N  In  the  currently  opened  output  file.  THe  segment  name  N  Is  an 
Integer  between  0  and  32000. 


OFCLSE 

Close  the  output  file. 

DFATTR  (FILENAME-POINTER,  X,  Y,  MAX-CHARS,  NO-CHARS,  COMMENT-POINTER) 

Obtain  the  precision  and  comment  information  from  a  graphic  file. 
FILENAME-POINTER  points  to  a  text  string  containing  the  file  name. 
COMMENT-POINTER  points  to  a  text  area  In  which  the  comment  Is  returned. 
MAX-CHARS  Is  an  Integer  specifying  the  maximum  size  set  by  the  system  to  the 
number  of  comment  characters  returned.  Integers  X  and  Y  are  file  precision. 


INFORMATION  ENQUIRY 


DENQ  (K.  VALUE) 

Enquire  about  the  status  of  the  system  and  current  values  of  parameters.  K  Is  an 
Integer  value  specifying  the  desired  array  entry;  VALUE  Is  In  the  format  as 
specified  for  the  Indicated  array  entry. 


OBAPHIC  INPUT 


DENABL (F) 

Enable  Input  facility  "F".  F  la  an  Integer. 


D08ABL  (F) 

Disable  the  Input  facility  "F".  F  la  an  Integer. 


08EN8E (D) 

Oeflne  the  sensitivity  distance  for  the  device  used  for  the  touching  facility.  D 
specifies  this  distance  In  centimeters  (as  a  real  number). 
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DINPUT  (W,  F.  K,  X,  Y) 

Get  Input  from  the  dovico.  F,  W,  and  K  aro  Integars;  X  and  Y  are  real  values.  For 
the  Tektronix  4010,  4012,  4014,  and  4027,  and  for  the  HP -2848 A,  keys  1-8  are 
function  keys  end  return  the  corresponding  Integers  key  0  Is  used  for  pointing  and 
touching  Input. 


DEFAULT  MODIFICATION 


DDFCLR  (I.  R.  G,  B) 

Set  color  default  values  for  DOPEN  processing.  The  parameters  sre  as  described 
under  DCOLOR. 


DDFTFA  (M.  F,  Q.  H.  W,  VS,  HS) 

Set  text  face/font  DOPEN  default  values.  Ths  parameters  are  as  described  under 
DTFACE. 


SCOPE  SELECTION 


DOFSCP  (N) 

Display  the  following  on  scope  N.  N  Is  an  Integer.  This  command  Is  currently  uaed 
In  the  Genlsco  and  AED512  for  Identifying  groups  of  memory  planes. 


M)$cei^.neous 


DCURSR  (X,  Y) 

Not  Implemented. 


OERROR  (ERROR,  SUBCODE,  CRITICALITY) 

Set  the  enquiry  array  error  bits.  ERROR  Is  an  Integer  value  from  1  to  85535, 
8UBC00E  an  Integer  from  0  to  65538,  and  CRITICALITY  an  Integer  from  0  to  1 5. 


DSYNCH 


Interpret  all  previously  Issued  Graphic  Language  commands. 


•  1 
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Appe  ndix  B 

THE  ERROR  COOES 


The  following  are  the  error  codes.  When  ERR-N  occurs.  2**(N-1)  Is  ORed  Into  ARRAY(I). 


ERR-01  System  error. 

ERR-02  System  tsble  overflow. 

ERR-03  No  open  segment. 

ERR-04  Segment  n  does  not  exist. 

ERR-05  The  system  does  not  support  this  call. 

ERR-06  Oevice/back-end  unknown,  or  not  available. 

ERR-07  Arguments  to  this  call  are  out  of  the  allowed  range. 
ERR-08  Undefined  Input  facility. 

ERR-09  Wrong  number  of  parameters. 

ERR- 10  No  facility  enabled. 

ERR-1 1  Communications  error. 

ERR- 12  Not  assigned  yet. 

ERR- 13  File  Input/output  error. 

ERR- 14  Not  assigned  yet. 

ERR- IS  Not  assigned  yet. 

ERR-1 0  Miscellaneous 


Appendix  C 

TEXT  PACES 


FACE  NAME 
ASCII 
CYRILLIC 
MATH  SET 


FACE  NAME  CODE 
1 
2 
3 
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Appendix  D 

SYSTEM  FILES 


The  Level  2  graphics  system  Is  distributed  as  five  files: 


L2SVS.REL 

L2F0R.REL 

L2BLI.REL 

L2FB.REL 

L2LISP.COM 


-  Graphics  System 

-  FORTRAN  Language  Interface 

-  BLISS  Language  Interface 

-  FORTRAN/BLISS  Language  Interface 

-  Interlisp  Language  Interface 


These  files  are  contained  In  <LEVEL2>  on  ISIB,  ISIC,  and  ISIE.  Files  can  be  retrieved 
using  FTP.  A  graphics  application  program  Is  formed  by  llnkedltlng  the  application 
program(s)  with  L2SYS.REL  and  either  L2F0R.REL,  L2BLI.REL.  or  L2FB.REL  depending  on 
whether  the  application  was  written  In  FORTRAN-10,  BLISS-10,  or  both. 
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USING  A  GRAPHICS  TERMINAL  ATTACHED  TO  A  "WILD"  TIP  PORT 


The  Graphic*  System  provides  the  capability  for  operating  a  graphics  terminal  from  an 
ARPANET  TIP  port.  A  typical  graphics  application  requires  two  terminals,  on* 
alphanumeric  terminal  for  controlling  the  program  and  performing  nongraphic* 
Input/output,  and  one  graphics  terminal  for  graphics  Input/output.  The  following 
procedure  Is  suggested  for  operating  In  this  modai 


1.  Set  the  baud  rata  of  the  graphics  terminal  and  TIP  port  (If  a  baud  rate  over 
300  baud  Is  daslrad).  To  ohanga  the  baud  rate  of  the  TIP  port,  enter  the 
TIP  command 


•DEVICE  RATE  # 

from  the  graphlos  terminal,  where  #  Is  a  1 0-blt  encoding  of  the  Input  and 


output  baud  rates. 

Example  values 

for  #  era: 

A 

Output  bsud 

Input  Baud 

373 

300 

300 

438 

600 

600 

503 

1200 

1200 

633 

2400 

2400 

629 

2400 

300 

693 

4800 

300 

757 

9600 

300 

See  the  TIP  User's  Guide  for  details  of  the  encoding  for  other  input/output 

rates. 


2.  Determine  the  TIP  port  number  to  which  the  graphics  terminal  Is  attached 
by  entering  the  TIP  command 


•RESET 


from  the  graphics  terminal.  The  octal  port  number  Is  the  last  number  In  the 
resulting  herald. 
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3.  8et  the  TIP  port  to  which  tho  graphics  terminal  It  attached  to  "wild"  mods 
by  entering  tho  TIP  command 

•SET  DEVICE  WILD 


from  tho  grapMca  terminal. 

4.  Login  and  run  tho  graphics  application  from  tho  alphanumeric  terminal.  (800 
Appendix  A  for  a  description  of  how  to  generate  the  graphlca  terminal  TIP 
address  for  the  INITIATE  command.) 

5.  At  the  completion  of  the  graphics  session,  remove  the  TIP  port  from  "wild" 
mode  by  entering  the  TIP  commands 


eCLEAR  DEVICE  U1L0 
oHOST  8 

from  the  grophlcs  terminal. 

8.  Restore  the  graphics  terminal  and  the  TIP  port  to  Its  previous  baud  rates  If 
appropriate. 


\ 


] 
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The  following  example  {«  Intended  to  help  the  novice  user 
understand  hou  GL  eight  be  used  to  satisfy  a  simple  graphice 
output  requirement.  The  example  utilizes  the  FORTRAN  language 
version  of  Q.  to  invoke  the  desired  graphics  functions.  The 
main  routine  builds  a  three-element  bar  chart,  each  element  of 
which  is  colored  and  filled  In  a  different  fashion.  The 
routine  creates  and  labels  an  axle  in  addition  to  creating 
the  filled  bar  chart  itself.  Subroutine  BOX  Is  invoked  with 
the  height  and  width  and  fill  mode  parameters  for  each  of  the 
three  elements  of  the  bar  chart.  The  subroutine  creatae  each 
box  such  that  it's  lower  left-most  corner  coincides  with  the 
current  beam  location.  The  remaining  comments  relate  to  the 
correspond I ng I g  numbered  comments  In  the  code  Itself. 

Comment  li 

The  subroutine  determines  the  current  location  of  the 
beam  bg  enquiring  on  ceils  89  and  98  of  the  enquiry 
array  which  contain  the  current  coordinates  of  the 
beam  in  window  units  (floating  point  values).  The 
values  In  cells  89  and  90  change  whenever  any  GL  cal  I 
is  Issued  that  affects  the  current  beam  location  (e.g. , 
HOVE,  ORAU,  TEXT).  Note  that  the  values  in  calls  89 
and  90  reflect  the  results  of  GL  calls  issued  during 
segment  creation!  they  have  nothing  whatsoever  to  do 
with  segment  drawing  and.  thus,  are  unaffected  by 
POSTlng,  UNPOSTlng,  HIGHLIGHTIng,  and  the  Ilk*. 

Comment  2t 

The  subroutine  utilizes  relative  draw  operations  to 
create  a  box  around  the  area  to  be  filled.  (The 
main  routine  positioned  the  beam  at  the  box  origin 
prior  to  Invoking  the  BOX  subroutine.) 

Comment  3t 

The  area  to  be  filled  le  specified  in  absolute 
coordinates  using  the  polygon  filling  capability.  The 
vertices  of  the  polygon  ere  specified  In  counter¬ 
clockwise  order  (clock-wise  order  Is  also  accepted)  and 
the  desired  filling  parameters  indicated.  The  vertex 
specification  is  bounded  by  the  DFILLP  cell  (indicating 
start  of  polygon  specification)  and  the  OFILLX  call 
(Indicating  completion  of  polygon  specification).  The 
inter-hatching  distance.  DIST.  is  specified  In  window 
uni te. 


•i 
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Comm ant  lit 

Th«  Main  rout i no  firot  initial Izes  the  graphics  devico 
connection  and  Indicates  the  coordinate  system  In  which 
the  user  wishes  to  operate.  A  backend  of  type 
"TEKTRONIX"  is  started  utilizing  communications  mode 
"0"  at  the  given  network  TIP  address.  The  aspect  ratio 
of  tho  desired  display  surface  viewing  area  is 
one-to-one.  The  default  window  values  are  overridden 
to  establish  a  coordinate  range  more  useful  to  the 
appl i cat  I  on. 

Comment  12s 

Specification  of  a  segment  with  the  name  "439"  Is 
begun.  Absolute  hOVEs  and  DRAUs  are  used  to  produce  a 
single  quadrant  coordinate  axis,  the  Y-eomponent  of 
which  receives  a  tic  nark  every  ten  units. 

Comment  13s 

The  default  text  specification  is  overridden  to  yield 
a  text  specification  which  selects  stroked  text  and 
results  in  a  vertically  descending  label  along  the 
Y-axis  of  the  chart.  This  text  specification  is 
immediately  overridden  with  a  new  specification  which 
results  in  additional  intercharacter  horizontal 
spacing  for  tho  default  character  font. 

Comment  14s 

Three  new  segments  are  created,  each  of  which 
overrides  the  segment  default  color  specification,  A 
single  new  color  is  utilized  for  the  contents  of  each 
segment,  produced  by  invoking  the  BOX  subroutine. 

Prior  to  each  invocation  of  the  BOX  routine,  the  beam 
Is  positioned  at  the  desired  box  origin  in  the  user’s 
coordinate  system. 

Comment  lSi 

One  of  tho  segments  just  created  is  highlighted. 

Cossmint  16) 

All  of  the  segments  created  by  the  preceding  code  are 
made  visible  in  a  single  operation.  Alternatively, 
each  segment  might  be  Individually  made  visible.  The 
connection  with  the  device  le  terminated  and  the 
program  exits. 
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SUBROUTINE  BOX  (YHGHT,  XUIDTH,  IFILL,  ANGLE.  OISTI 
Cl 

Cl  get  the  currant  x,y  baaa  positron 
Cl 

CALL  OENQ  (89, X) 

CALL  OENQ  (98, VI 
C2 

C2  drau  tha  box  at  tha  current  baaa  position  using  relative  draus 
C2 

CALL  ORORAU  (XUIDTH, 8.) 

CALL  ORORAU  (8.. YHGHT) 

CALL  ORORAU  (-XUI0TH.8.) 

CALL  ORORAU  (8., -YHGHT) 

C3 

C3  specify  tha  polygon  vertices  for  filling 
C3 

CALL  OF I LLP 

CALL  OVERTX  (X+XUIOTH.Y) 

CALL  OVERTX  (X+XUIOTH, Y+YHGHT) 

CALL  OVERTX  (X.Y+YHGHT) 

CALL  OVERTX  (X.Y) 

CALL  OFILLX  (IFILL, ANGLE, DIST) 

RETURN 

END 

CU 

Cll  initialize  the  graphics  systea  and  sat  ulndou 
CU 

CALL  DINIT  ( 

X  *  BACKEND-  ( TEXTRON  IX),  DEV  I CE- (0,  NET  1 1 .  NPS-T I P-768B883 » T )  \1. ) 
CALL  DUINDO  (-28., -28. ,118.,  118.1 
C12 

C12  drau  axis  ulth  tic  narks  In  uhlte  in  sagaant  439 
C12 

CALL  OOPEN  (439) 

CALL  0T10VE  (8.,  188. 1 
CALL  DORAU  (8., 8.) 

CALL  OORAU  (188.. 8. I 
00  8188  1-18,188,18 
TIC  -  I 

CALL  DROVE  (-2.. TIC) 

CALL  ORORAU  (2., 8.) 

8188  CONTINUE 
C13 

C13  aalact  text  and  label  axis  and  chart 
C13 

CALL  OTFACE  (S3, 1,1,5., 3., -18., -3.) 

CALL  OROVE  (-18., 78.) 

CALL  OTEXT  (4, ’LOAD’) 

CALL  OTFACE  (32, 8, 8, 8., 8., 8.,  1.) 

CALL  OROVE  (-5., -18.) 

CALL  OTEXT  (34, 'Systea  Load  for  3  Consecutive  Days') 

CALL  OCLOSE 
C14 

C14  drau  three  boxes  in  sagaants  1629-1631 
C14 


CALL  OOPEN  (1629) 


eo 
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CALL  DCOLOR  (1. ,1. . .5,8.) 

CALL  OtlOVE  (8.  ,0. ) 

CALL  BOM  US.  ,38.  ,2,3.1416/4.  ,2.) 
CALL  OCLOSE 
CALL  OOPEN  (1638) 

CALL  0C0L0R  (1. , .5,8. , .7) 

CALL  OTIOVE  (38.,  8.) 

CALL  BOM  (38., 38.. 1.3.1416/5., 2.) 
CALL  OCLOSE 
CALL  OOPEN  (1631) 

CALL  OCOLOR  (1. ,1. .8. . .8) 

CALL  OTIOVE  (68., 8.) 

CALL  BOM  (88.,  38.,  3. 8.,  8.) 

CALL  OCLOSE 
CIS 

CIS  highlight  ons  of  the  boxes 
CIS 

CALL  OHLGHT  (1638,1) 

C16 

C16  Make  everything  visible  and  terminate 
C16 

CALL  OPOST  (8) 

CALL  OREL 
END 
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Appendix  G 

MENU  CAPABILITY 


It  Is  common  practice  for  graphics  programs  to  present  to  the  person  using  the  system  a 
choice  of  several  options.  Frequently,  a  menu-like  presentation  of  the  options  is  used, 
each  Identified  by  an  alphanumeric  string  describing  it.  The  user  Indicates  his  choice  by 
positioning  a  cursor,  touching  the  corresponding  string,  hitting  a  key,  etc.  Since  the 
exact  manner  In  which  the  user  Indicates  his  choice  Is  often  irrelevant  to  the  application 
program,  and  since  It  depends  on  the  particular  devices  available,  a  FORTRAN- 10  MENU 
eubroutlne  has  been  provided  that  allows  the  graphics  programmer  to  leave  theae  details 
to  be  arranged  between  the  user  and  the  system  at  run  time. 


MENU  (KEY, N, LIST) 

Choose  one  out  of  N  possibilities  (menu  selection). 

N  (an  Integer)  Is  the  number  of  possible  choices,  and  LIST  Is  a  list  of  alphanumeric  strings 
describing  them.  The  system  sets  KEY  to  an  integer  between  1  and  N,  corresponding  to 
the  user's  choice.  Control  Is  not  returned  to  the  calling  sequence  until  the  choice  Is 
made.  At  the  time  this  call  Is  Issued,  an  Implicit  CLOSE  and  UNPOST(O)  are  performed. 
After  the  selection  Is  made,  the  MENU  disappeara  from  the  CRT. 

The  exact  format  of  LIST  depends  on  the  implementation  environment.  The  menu 
selection  may  be  implemented  either  by  a  positioning  device,  function  keys  or  any  other 
means,  as  decided  by  the  system  at  run  time.  The  specification  of  these  means  Is  not 
available  to  the  application  program. 

Possible  errors: 

ERR-07  N<1  or  N>20. 

ERR- 16  Wrong  LIST  format. 


The  FORTRAN- 10  source  code  for  the  MENU  subroutine  Is  contained  In  the  file 
L2MENU.F0R  In  <LEVEL2>  on  ISIB,  ISIC,  and  ISIE.  If  the  MENU  subroutine  Is  used, 
L2MENU.F0R  must  be  compiled  and  Its  REL-flle  Included  In  the  tlnkedlt  of  the  application 
program. 
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Appendix  H 

DIFFERENCES  BETWEEN  VERSI0N8  OF  GRAPHICS  LANGUAGE. 


While  an  attempt  has  baan  made  to  maintain  upward  compatibility  batwaan  Versions  of 
Graphics  Language,  In  several  Instances  It  has  been  necessary  to  change  calls  to 
accommodate  new  features  or  to  add  new  calls  to  refteot  Increased  capability.  Theee 
changes  and  the  new  features  are  noted  below. 

[DIFFERENCES  BETWEEN  VERSION  1.0  AND  VER8I0N  2.0] 

1 .  INITIATE  command  changed.  The  parameters  to  the  INITIATE  command  have 
been  changed.  The  first,  CONFIGURATION-STRING,  Indicates  the  desired 
configuration.  The  aecond,  ASPECT-RATIO,  Indicates  the  desired  aspect 
ratio  for  a  graphic  output  work-area  to  be  allocated  to  the  application 
program  for  this  connection.  The  entire  display  surface  Is  no  longer 
automatically  made  available  to  the  application  program.  If  It  Is  not  being 
used  for  any  other  purpose,  the  entire  display  surface  can  be  made 
available  to  the  application  program  If  the  application  program  specifies  an 
aspect  ratio  value  less  than  0.,  which  requests  that  a  work-area  with  the 
same  aspect  ratio  as  the  full  display  surface  be  allocated  to  the 
application  program. 

2.  POST  command  changed.  The  post  command  no  longer  causes  the  currently 
open  segment  to  be  closed  and  posted  if  the  post  segment  ID  Is  the  same 
as  the  currently  open  segment.  The  currently  open  segment  must  bo 
explicitly  closed  before  Its  ID  becomes  available  for  segment  manipulation. 

3.  APPEND  command  deleted.  The  equivalent  capability  has  been  made 
available  via  the  MERGE  command  discussed  below. 

4.  MERGE  command  added.  A  command  has  been  added  to  the  graphics 
system  permitting  one  segment  to  be  merged  with  another  segment.  If  the 
second  segment  does  not  exist  the  first  segment  will  be  renamed  to  that  of 
the  second  segment. 

5.  ERROR  command  added.  A  command  has  been  added  to  the  graphics 
system  permitting  the  application  program  to  set  the  error  Information 
accumulatad  within  the  graphlea  system. 

0.  TEXTBIZE  command  replaced.  The  TEXT8IZE  (previously  not  Implemented) 
has  been  replaced  by  a  TEXTFACE  command  that  supplies  Information 
regarding  text  selection. 
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7.  ENQUIRY  array  changed.  Subatantlal  ohangaa  have  baen  made  to  the 
format  of  the  enquiry  array  to  accommodate  new  Information.  Moat  of 
thaaa  changea  are  with  regard  to  faaturaa  previously  unimplemented. 
Where  possible,  existing  enquiry  array  entries  were  kept  In  the  same 
location  as  previously  defined. 

6.  Filling  added.  FILL-POLYGON,  VERTEX  and  TERMINATE -POLYGON  have  been 
added  to  support  polygon  filling.  FILL-SECTOR  Has  been  added  to  support 
circular  sector  filling. 

Q.  Open  default  modification  commands  added  DEFAULT-TEXT  and 
OEFAULT-COLOR  have  been  added  to  alter  the  standard  defaults  for  open 
processing  to  Improve  system  performance  and  minimize  the  TEXTFACE  and 
COLOR  calls  that  must  be  issued  to  achieve  the  desired  result. 

10.  SCOPE  command  changed.  The  first  argument  to  the  SCOPE  command  has 
been  changed  from  a  scope  number  specifying  a  single  scope  to  a  scope 
mask. 


[DIFFERENCES  BETWEEN  VERSION  2.0  ANO  VERSION  2.1] 


1. GL  FILE  capability  added.  OPEN-OUTPUT-FILE,  WRITE-SEGMENT, 
CLOSE-OUTPUT-FILE,  READ-FILE,  and  READ-FILE-ATTRIBUTES  have  been 
added  to  allow  the  user  to  create  and  playback 
dlaplay-devlce-lndependent  graphic  files. 

2.  SYNCHRONIZE  command  added.  The  command  allows  the  user  to  cause  ail 
previously  Issued  GL  commands  to  be  completed. 

3.  SCOPE  command  renamed.  SCOPE  has  baen  changed  to  DEFAULT-SCOPE 
with  a  single  parameter,  a  mask  of  enabled  scopes. 

4.  INPUT  command  parameter  added.  The  walt-for-lnput  option  previously 
specified  by  the  "FH  parameter  Is  now  specified  by  a  new  parameter,  "W". 

6.  INITIATE  options  added.  The  INITFILE  parameter  allows  configuration-string 
Information  to  be  obtained  from  a  file. 
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